Teller MCP – Borrow USDC & Altcoins

---

name: tellermcp-mcp description: Expose the Teller delta-neutral + lending Model Context Protocol server. Use this when you need to install, run, or update the Tellermcp MCP backend so agents can fetch opportunities, borrow terms, and on-chain tx builders for Teller.

---

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.