MCP Tools Reference

{
  facts: Array<{
    id: string
    memory_text: string
    author_name: string
    message_ts: string
    quality_score: number
    topic_tags: string[]
    entity_tags: string[]
    importance: "low" | "medium" | "high"
  }>
  relationships?: Array<{
    source: string
    type: string
    target: string
    confidence: number
    context: string
  }>
}

const result = await mcp.call("search_channel_knowledge", {
  channel_id: "C12345",
  query: "authentication JWT tokens",
  include_graph: true
});

console.log(`Found ${result.facts.length} facts`);
result.facts.forEach(fact => {
  console.log(`- ${fact.memory_text} (by ${fact.author_name})`);
});

{
  content: string           // Markdown content
  generated_at: string      // ISO timestamp or null
}

const page = await mcp.call("get_wiki_page", {
  channel_id: "C12345",
  page_type: "decisions"
});

console.log(page.content);

{
  experts: Array<{
    name: string
    score: number          // Expertise score
    evidence: string[]     // Supporting facts/messages
  }>
}

const experts = await mcp.call("find_experts", {
  channel_id: "C12345",
  topic: "authentication"
});

experts.experts.forEach(expert => {
  console.log(`${expert.name} (score: ${expert.score})`);
  expert.evidence.forEach(e => console.log(`  - ${e}`));
});

{
  name: "beever-atlas",
  instructions: "Beever Atlas knowledge API. Search channel facts, retrieve wiki pages, and find domain experts from team communication history."
}

{
  "mcpServers": {
    "beever-atlas": {
      "command": "node",
      "args": ["path/to/mcp-client.js"],
      "env": {
        "BEEVER_ATLAS_URL": "http://localhost:8000"
      }
    }
  }
}

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "python",
  args: ["-m", "beever_atlas.api.mcp"]
});

const client = new Client({
  name: "beever-atlas-client",
  version: "1.0.0"
}, {
  capabilities: {}
});

await client.connect(transport);

// List available tools
const { tools } = await client.listTools();

// Call a tool
const result = await client.callTool({
  name: "search_channel_knowledge",
  arguments: {
    channel_id: "C12345",
    query: "authentication",
    include_graph: false
  }
});