MCP quickstart

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 
const client = new Client({ name: "myagent", version: "0.1.0" }, { capabilities: {} });
await client.connect(new StdioClientTransport({
  command: "npx",
  args: ["-y", "@blockchainacademics/mcp"],
  env: { BCA_API_KEY: process.env.BCA_API_KEY!, BCA_CLIENT_NAME: "myagent" },
}));
 
const result = await client.callTool({
  name: "search_news",
  arguments: { q: "circle mica", limit: 5 },
});
 
// MCP wraps the envelope as the first text content block:
const envelope = JSON.parse(result.content[0].text);
 
// Happy-path guard
if (envelope.meta.status !== "complete") {
  console.warn(
    `[${envelope.meta.request_id}] status=${envelope.meta.status}`,
    envelope.meta.diagnostic,
  );
}
 
// Pull the primary citation — always citations[0]
const primary = envelope.attribution.citations[0];
console.log("Source:", primary.cite_url);
console.log("As of:", primary.as_of);
 
// Use the data
for (const item of envelope.data.items) {
  console.log(`- ${item.title} (${item.slug})`);
}

import json
import os
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
 
server_params = StdioServerParameters(
    command="uvx",
    args=["bca-mcp"],
    env={"BCA_API_KEY": os.environ["BCA_API_KEY"], "BCA_CLIENT_NAME": "myagent"},
)
 
async with stdio_client(server_params) as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
 
        result = await session.call_tool(
            "search_news",
            arguments={"q": "circle mica", "limit": 5},
        )
 
        # MCP wraps the envelope as the first text content block:
        envelope = json.loads(result.content[0].text)
 
        # Happy-path guard
        if envelope["meta"]["status"] != "complete":
            print(
                f"[{envelope['meta']['request_id']}] "
                f"status={envelope['meta']['status']}",
                envelope["meta"].get("diagnostic"),
            )
 
        # Pull the primary citation — always citations[0]
        primary = envelope["attribution"]["citations"][0]
        print("Source:", primary["cite_url"])
        print("As of:", primary["as_of"])
 
        # Use the data
        for item in envelope["data"]["items"]:
            print(f"- {item['title']} ({item['slug']})")