publicKnowledgeJan 1, 20260 calls

Notion MCP Template

Curated MCP template for pages, databases, blocks, and knowledge workflows.

Hosted MCP endpoint

/api/mcp/preset-notion

Private servers require an Astrail API key in the Authorization header.

MCP client snippets

Claude Desktop config

{
  "mcpServers": {
    "notion-mcp-template": {
      "url": "/api/mcp/preset-notion"
    }
  }
}

cURL initialize

curl -sS -X POST "/api/mcp/preset-notion" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

cURL tools/list

curl -sS -X POST "/api/mcp/preset-notion" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

cURL tools/call

curl -sS -X POST "/api/mcp/preset-notion" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"notion_search","arguments":{"query":"example"}}}'

Runtime behavior

Runtime healthneeds_mapping

Endpoint healthnot_checked

Execution modemapping_required

Deterministic executionNot yet executable

Generated sourceExport only

Endpoint mapRequired

Endpoint mappedNo

Auth-required endpointsNone detected

Browser runtime endpointsNone detected

Last statusnot recorded

Last execution modenot recorded

Last toolnot recorded

Last latencynot recorded

Upstream statusnot recorded

Trace IDnot recorded

Error codenone

Observabilitystructured fallback

Rate limit modestandard

Missing authauth_required

Missing mappingmapping_required

Astrail does not evaluate generated TypeScript inside Next.js. Hosted calls are routed through stored tool metadata and endpoint maps.

Tools

notion_search

Search Notion pages and databases for agent-readable knowledge.

notion_query_database

Query a Notion database with simple filters and sorting.

notion_create_page

Create a Notion page in a database or parent page.

server.ts

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({ name: "Notion MCP Template", version: "1.0.0" });

// Curated Astrail template. Add the provider API token and replace the
// placeholder handlers with real fetch calls for: notion_search, notion_query_database, notion_create_page.

server.tool("template_status", "Confirm this curated MCP template is installed.", z.object({}), async () => ({
  content: [{ type: "text", text: "Template installed. Add provider credentials to enable live API calls." }],
}));

const transport = new StdioServerTransport();
await server.connect(transport);