What can you do with agentcite?

AgentCite

Fabrication-free, DOI-backed citations for AI content & agents. Every result is a real openAlex record (CC0 public-domain data) with a resolvable DOI — the API never fabricates a source. Built to stop the hallucinated-citation problem that gets content E-E-A-T-demoted.

Separate deployable from giftedpicks.com (own Vercel project). Productizes the logic of GiftedPicks/scripts/citation_magnet.py.

API (MVP)

GET /api/cite?topic=<q>&n=5&since=YYYY → { topic, count, works[], markdown, source }
- each work: { title, authors[], first_author, year, doi, doi_url, cited_by_count, venue, openalex_id }
GET /api/health → { status, openalex, ts }

Data: openAlex REST (relevance-ranked, peer-reviewed type:article). Set OPENALEX_MAILTO env to join openAlex's polite pool. Edge-cached 1h per topic.

Roadmap (build order)

✅ Core /cite + /health (openAlex REST, no key, no binary — serverless-portable)
⏳ API-key + quota gate (Supabase: anon free tier rate-limited vs keyed Pro)
⏳ MCP server: get_citations(topic, n, since) (stdio + http) — the agent-native surface
⏳ Stripe billing (TEST mode first; hosted Checkout/Payment Link → webhook provisions quota). GATED: needs .claude/secrets/stripe-test-{publishable,secret}-key saved by Kevin. LIVE go-live = Kevin places the live secret key in the deploy env; agents never hold it.
Landing page + MCP-registry listings — owned by Cowork.

Guardrails

Public-domain data only (zero scraping / no unofficial-site APIs). Honesty is the product: output always says "verify each DOI resolves." Test-mode payments only until Kevin flips live; agents never move money or hold the live key.

Billing (Stripe)

Pro tier via hosted Stripe Checkout (subscription). On checkout.session.completed, the signature-verified webhook (/api/stripe-webhook) provisions a Pro API key in Redis (free→Pro quota elevation). Configure via env:

STRIPE_SECRET_KEY, STRIPE_PRICE_ID, STRIPE_WEBHOOK_SECRET, REDIS_URL
Create the Pro product/price once: STRIPE_SECRET_KEY=sk_test_… node scripts/setup-stripe-product.js
Without Stripe env set, /api/checkout returns 503 and the citation API still runs free-tier.

Install

Add agentcite to your client. Pick the one you use.

claude mcp add agentcite-mcp -- npx -y agentcite-mcp

codex mcp add agentcite-mcp -- npx -y agentcite-mcp

amp mcp add agentcite-mcp -- npx -y agentcite-mcp

{
  "mcpServers": {
    "agentcite-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentcite-mcp"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "agentcite-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentcite-mcp"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"agentcite-mcp","command":"npx","args":["-y","agentcite-mcp"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

{
  "mcpServers": {
    "agentcite-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentcite-mcp"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "agentcite-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentcite-mcp"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "agentcite-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentcite-mcp"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "agentcite-mcp": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "agentcite-mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "agentcite-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "agentcite-mcp"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y agentcite-mcp

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

Score

39 / 100

Incomplete

Documentation16/25
Maintenance16/25
Trust6/20
Capability0/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 68 days ago
Has a release history
Repository is not archived
No licence detected
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
12 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
0.1.1Latest	Jun 27, 2026