- 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
cd scripts/tellermcp-servernpm install- (Optional) Configure env vars:
- TELLER_API_BASE_URL (defaults to https://delta-neutral-api.teller.org) - TELLER_API_TIMEOUT_MS (defaults to 15000 ms)
npm run build→ TypeScript type-check.npm start→ launchestellermcpMCP server over stdio.
Repo Layout (scripts/tellermcp-server/)
package.json/package-lock.json– Node 20+ project metadatatsconfig.json– ES2022/ESNext build targetssrc/client.ts– Typed Teller REST client (fetch wrapper + filters)src/types.ts– TypeScript interfaces for all Teller responsessrc/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 installThe 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. Usegh pr checksornpm 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
- Edit TypeScript files inside
src/. npm run buildlocally.- Commit + push via GitHub skill (if syncing to
teller-protocol/teller-mcp). - 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-mcpThe packager validates SKILL.md + resources and emits tellermcp-mcp.skill (zip) for distribution.