keyfo docs

curl https://keyfo.xyz/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEYFO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "messages": [
      {
        "role": "user",
        "content": "In one sentence, what is a stock token?"
      }
    ]
  }'

import os
from openai import OpenAI

client = OpenAI(base_url="https://keyfo.xyz/v1", api_key=os.environ.get("KEYFO_KEY", "YOUR_KEYFO_KEY"))
r = client.chat.completions.create(
    model="openai/gpt-4.1-mini",
    messages=[{"role": "user", "content": "In one sentence, what is a stock token?"}],
)
print(r.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://keyfo.xyz/v1", apiKey: process.env.KEYFO_KEY ?? "YOUR_KEYFO_KEY" });
const r = await client.chat.completions.create({
  model: "openai/gpt-4.1-mini",
  messages: [{ role: "user", content: "In one sentence, what is a stock token?" }],
});
console.log(r.choices[0].message.content);

Authorization: Bearer YOUR_KEYFO_KEY
# MCP clients that take only a URL:
https://keyfo.xyz/mcp?key=YOUR_KEYFO_KEY

curl -X POST https://keyfo.xyz/api/trial

curl https://keyfo.xyz/v1/models

Claude CodeCursorVS CodeREST

Copy

claude mcp add -s user --transport http keyfo https://keyfo.xyz/mcp \
  --header "Authorization: Bearer YOUR_KEYFO_KEY"

{
  "mcpServers": {
    "keyfo": {
      "url": "https://keyfo.xyz/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEYFO_KEY"
      }
    }
  }
}

{
  "servers": {
    "keyfo": {
      "type": "http",
      "url": "https://keyfo.xyz/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEYFO_KEY"
      }
    }
  }
}

curl "https://keyfo.xyz/v1/tools/stock_quote?ticker=NVDA" \
  -H "Authorization: Bearer YOUR_KEYFO_KEY"

curl https://keyfo.xyz/v1/stocks

import { createWalletClient, createPublicClient, http, defineChain } from "viem";
import { privateKeyToAccount } from "viem/accounts";

const chain = defineChain({
  id: 4663,
  name: "Robinhood Chain",
  nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
  rpcUrls: { default: { http: ["https://rpc.mainnet.chain.robinhood.com"] } },
});
const account = privateKeyToAccount(process.env.AGENT_KEY as `0x${string}`);
const wallet = createWalletClient({ account, chain, transport: http() });
const client = createPublicClient({ chain, transport: http() });

const res = await fetch("https://keyfo.xyz/v1/tools/build_trade", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_KEYFO_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    token: "TSLA", side: "buy", wallet: account.address, usd: 50,
  }),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error.message);
const trade = body.data;
if (Date.now() / 1000 > trade.valid_until) {
  throw new Error("Quote expired: build the trade again");
}

for (const c of trade.calls) {
  const hash = await wallet.sendTransaction({
    to: c.to,
    data: c.data,
    value: BigInt(c.value),
    gas: c.gas ? BigInt(c.gas) : undefined,
  });
  const receipt = await client.waitForTransactionReceipt({ hash });
  if (receipt.status !== "success") throw new Error(c.label);
}

import OpenAI from "openai";

const BASE = "https://keyfo.xyz";
const KEY = process.env.KEYFO_KEY ?? "YOUR_KEYFO_KEY";
const client = new OpenAI({ baseURL: `${BASE}/v1`, apiKey: KEY });

const list = await fetch(`${BASE}/mcp`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
    Accept: "application/json, text/event-stream",
  },
  body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/list" }),
}).then((r) => r.json());
const tools = list.result.tools.map((t) => ({
  type: "function" as const,
  function: {
    name: t.name,
    description: t.description,
    parameters: t.inputSchema,
  },
}));

const messages: OpenAI.ChatCompletionMessageParam[] = [
  { role: "user", content: "What is NVDA trading at on Robinhood Chain?" },
];

while (true) {
  const r = await client.chat.completions.create({
    model: "openai/gpt-4.1-mini",
    messages,
    tools,
  });
  const msg = r.choices[0].message;
  messages.push(msg);
  if (!msg.tool_calls?.length) { console.log(msg.content); break; }
  for (const call of msg.tool_calls) {
    const url = `${BASE}/v1/tools/${call.function.name}`;
    const res = await fetch(url, {
      method: "POST",
      headers: {
        Authorization: `Bearer ${KEY}`,
        "Content-Type": "application/json",
      },
      body: call.function.arguments,
    });
    const content = await res.text();
    messages.push({ role: "tool", tool_call_id: call.id, content });
  }
}