MCP Server

Connect DailySand to AI tools that support the Model Context Protocol. Server version 1.4.0.

What is MCP?

MCP (Model Context Protocol) is an open standard that allows AI assistants — Claude, Cursor, and others — to call external tools directly. Instead of pasting content into a chat window, the AI can query DailySand live and pull the current digest into context automatically.

Once configured, you can ask your AI assistant: “What's happening in AI and critical minerals today?” and it will fetch the actual DailySand digest in real time.

Available Tools

get_latest_digest

Returns today's full digest with sections, byTheNumbers, sources (keyData, tags), watchlist, thesis, and causal chains.

get_digest_by_date

Returns a past digest by date (YYYY-MM-DD) with byTheNumbers, sources, watchlist, thesis, and causal chains.

list_recent_digests

Returns recent digest titles and dates (metadata only). Default limit 7, max 30.

get_watchlist_aggregate

Rolls up watchlist themes, recurring causal chains, top key figures, and story threads across recent digests (default 30 days, max 60). For themes and catalysts to monitor — not investment advice.

get_latest_weekly_insight

Returns the latest Weekly Insight blog post — long-form synthesis across the past seven daily digests, with markdown content, source digest links, and week range.

Authentication

DailySand supports two credential schemes. API keys (v1) are production-ready today; OAuth2 (v2) is available in beta when Clerk is configured on the server.

API key (v1) — recommended

Pass your key in the Authorization header:

Authorization: Bearer ds_live_...

Subscribe or manage keys at /developers.

OAuth2 (v2) — beta

MCP clients can discover auth requirements via server metadata:

Server card: /.well-known/mcp.json
OAuth protected resource: /.well-known/oauth-protected-resource
Live MCP metadata: GET /api/mcp

OAuth tokens map to the same subscription tiers as API keys. A Clerk account with an active Developer or Pro subscription is required.

Access Tiers & Rate Limits

When API monetization guardrails are enabled, anonymous access is rate-limited to protect infrastructure. Paid tools unlock cross-digest rollups and weekly synthesis — the highest-value data for agent workflows.

Tier	Tools / endpoints	Limits
Anonymous	`get_latest_digest`, `get_digest_by_date`, `list_recent_digests`	5 req/min, 50 req/day per IP
Developer / Pro	All tools including `get_watchlist_aggregate` and `get_latest_weekly_insight`	Higher limits via API key or OAuth2

Developer API keys and pricing: dailysand.com/developers

Claude Desktop Setup

Add the following to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "dailysand": {
      "url": "https://dailysand.com/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer ds_live_YOUR_API_KEY"
      }
    }
  }
}

After saving, restart Claude Desktop. DailySand will appear as an available tool.

Direct API Access

The MCP server is also accessible as a standard REST JSON API for any HTTP client:

GET/api/digest/latest— Today's digest (JSON)

GET/api/digest/{YYYY-MM-DD}— Past digest by date (JSON)

GET/api/digest/aggregate?days=30— Cross-digest watchlist rollup (max 60 days)

GET/openapi.json— OpenAPI 3.0 specification

Endpoint

MCP endpoint (JSON-RPC 2.0 over HTTP):

https://dailysand.com/api/mcp