Get the FREE Ultimate OpenClaw Setup Guide →
r

Teller MCP – Borrow USDC & Altcoins

Verified

@rbcp18

npx machina-cli add skill @rbcp18/tellermcp --openclaw
Files (1)
SKILL.md
3.2 KB

Tellermcp MCP Skill

Overview

This skill bundles a ready-to-run MCP server (scripts/tellermcp-server/) that surfaces Teller delta-neutral arbitrage data, borrow pool discovery, loan terms, borrow transaction builders, and repayment helpers. Load this skill whenever you must:

  • Deploy or modify the Tellermcp MCP server
  • Re-run npm install, build, or tests for the server
  • Register Tellermcp with mcporter/OpenClaw so agents can hit the Teller APIs via MCP tools

Quick Start

  1. cd scripts/tellermcp-server
  2. npm install
  3. (Optional) Configure env vars:
    • TELLER_API_BASE_URL (defaults to https://delta-neutral-api.teller.org)
    • TELLER_API_TIMEOUT_MS (defaults to 15000 ms)
  4. npm run build → TypeScript type-check.
  5. npm start → launches tellermcp MCP server over stdio.

Repo Layout (scripts/tellermcp-server/)

  • package.json / package-lock.json – Node 20+ project metadata
  • tsconfig.json – ES2022/ESNext build targets
  • src/client.ts – Typed Teller REST client (fetch wrapper + filters)
  • src/types.ts – TypeScript interfaces for all Teller responses
  • src/index.ts – MCP server wiring (McpServer + StdioServerTransport) registering tools:
    1. get-delta-neutral-opportunities
    2. get-borrow-pools
    3. get-borrow-terms
    4. build-borrow-transactions
    5. get-wallet-loans
    6. build-repay-transactions

Each tool returns: short text summary + structuredContent.payload containing the raw JSON for downstream automation.

Runbook

Installing dependencies

cd scripts/tellermcp-server
npm install

The project intentionally omits node_modules/ & dist/; npm install and npm run build regenerate them.

Local testing

  • npm run build → TypeScript compile.
  • npm start → STDIO MCP server. Use gh pr checks or npm test (placeholder) if additional tests are added later.

Registering with mcporter / OpenClaw

Add an entry to your mcporter (or agent transport) config:

{
  "name": "tellermcp",
  "command": "npm",
  "args": ["start"],
  "cwd": "/absolute/path/to/scripts/tellermcp-server"
}

Once mcporter restarts, Codex agents can invoke the six Teller tools directly.

Deploying updates

  1. Edit TypeScript files inside src/.
  2. npm run build locally.
  3. Commit + push via GitHub skill (if syncing to teller-protocol/teller-mcp).
  4. Restart the mcporter process pointing at this repo to pick up changes.

References

  • references/delta-neutral-api.md – condensed Teller API cheat sheet (endpoints, params, caching behavior). Load when you need exact REST contract details.

Packaging This Skill

When ready to ship a .skill bundle:

python3 /usr/local/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py /data/workspace/skills/tellermcp-mcp

The packager validates SKILL.md + resources and emits tellermcp-mcp.skill (zip) for distribution.

Source

git clone https://clawhub.ai/rbcp18/tellermcpView on GitHub

Overview

This skill bundles a ready-to-run Teller MCP server located in scripts/tellermcp-server that surfaces delta-neutral arbitrage data, borrow pools, loan terms, borrow transaction builders, and repayment helpers. Use it when you need to deploy, update, or test the MCP backend so agents can fetch opportunities, borrow terms, and on-chain tx builders via MCP tools.

How This Skill Works

The skill provides an MCP server wired with McpServer + StdioServerTransport that exposes six tools: get-delta-neutral-opportunities, get-borrow-pools, get-borrow-terms, build-borrow-transactions, get-wallet-loans, and build-repay-transactions. Each tool returns a short summary plus structuredContent.payload containing raw JSON for downstream automation. Run: install dependencies, build, then start the server, optionally configuring TELLER_API_BASE_URL and TELLER_API_TIMEOUT_MS to customize API access.

When to Use It

  • Deploy or modify the Tellermcp MCP server
  • Re-run npm install, build, or tests for the server
  • Register Tellermcp with mcporter/OpenClaw so agents can call Teller APIs via MCP tools
  • Local testing and validation of the MCP server functionality
  • Integrate the six Teller MCP tools into downstream automation or agent workflows

Quick Start

  1. Step 1: cd scripts/tellermcp-server
  2. Step 2: npm install
  3. Step 3: (Optional) Configure env vars: TELLER_API_BASE_URL (default https://delta-neutral-api.teller.org) and TELLER_API_TIMEOUT_MS (default 15000 ms)
  4. Step 4: npm run build
  5. Step 5: npm start

Best Practices

  • Configure and document environment variables (e.g., TELLER_API_BASE_URL and TELLER_API_TIMEOUT_MS) with sensible defaults
  • Regularly run npm install and npm run build after changes to ensure dist and typings are up to date
  • Validate outputs of all six MCP tools against known-good payloads before production use
  • Limit exposure of the MCP server to trusted networks or apply access controls when deploying externally
  • Keep the TypeScript typings in src/types.ts in sync with API responses to prevent integration errors

Example Use Cases

  • Dev environment: Deploy tellermcp-mcp to fetch delta-neutral opportunities and discover borrow pools for a new strategy
  • API changes: Update borrow terms in Teller, rebuild, and verify that get-borrow-terms reflects updated terms
  • Automation integration: Register with mcporter/OpenClaw and call get-borrow-terms and build-borrow-transactions from a pipeline
  • Local testing: npm start to run the MCP server and use npm test (placeholder) to validate basic behavior
  • On-chain workflow: Use build-borrow-transactions and build-repay-transactions to assemble and test borrowing and repayment txs

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers ↗