tellermcp-mcp

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.