Teller MCP – Borrow USDC & Altcoins (no margin calls)

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 agent...

Security Scan

The skill's code, instructions, and declared behavior are internally consistent with its stated purpose (a local MCP server that proxies Teller delta‑neutral and lending APIs), but the package provenance is unknown so you should review before running.

Purpose & Capability

The name/description match the included files: TypeScript MCP server code registers the six tools described, client.ts calls the documented Teller REST endpoints, and package.json lists @modelcontextprotocol/sdk and zod which are reasonable dependencies for an MCP server. Inputs, outputs, and endpoints align with the stated purpose.

Instruction Scope

SKILL.md instructs standard developer ops (npm install, build, npm start) and how to register the server with mcporter/OpenClaw. The runtime behavior is limited to making HTTP requests to the Teller API and returning structured JSON — it does not instruct reading unrelated system files or secrets. The README and code reference optional env vars (TELLER_API_BASE_URL, TELLER_API_TIMEOUT_MS) which are used as documented.

Install Mechanism

This is instruction-only (no automated install spec). Running it requires npm install which will fetch packages from the public registry; a package-lock.json is included (good for reproducibility). There is no download-from-arbitrary-URL step. However, the skill has no homepage/repository metadata in the registry entry, so provenance is unclear.

Credentials

The skill does not require any credentials or config paths. The only environment variables mentioned are optional and used to point the client at a different base URL or adjust timeouts. The code accepts wallet addresses as inputs and returns unsigned transaction payloads; it does not request private keys or tokens in the provided files.

Persistence & Privilege

The skill is not marked always:true and does not attempt to modify other skills or global agent settings. It runs as a standalone MCP server process and can be invoked by agents (default behavior) which is appropriate for a tool-exposing service.

Assessment

This bundle appears to be what it claims (a local MCP server fronting Teller's public delta‑neutral API). Before installing or running it: 1) verify the source (there is no homepage/repo listed) — prefer code from a known org or repo; 2) inspect package.json and the package-lock.json for unexpected dependencies; 3) run npm audit / npm ci in an isolated environment or container to avoid exposing your main system; 4) do not supply private keys or wallet seed phrases — the server builds transaction calldata but does not sign or submit transactions; 5) consider setting TELLER_API_BASE_URL to a local mock for testing, and confirm the production base URL matches the official Teller endpoint (https://delta-neutral-api.teller.org); and 6) review the @modelcontextprotocol/sdk dependency if you rely on strict provenance. If you need higher assurance, ask the publisher for a verifiable repository or have a developer perform a dependency and provenance review prior to deployment.

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.