English Français العربية

io.github.Kevinx702/agentcite

Official registry AI and agents

Fabrication-free, DOI-backed citations for AI agents — real openAlex sources, never hallucinated.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package agentcite-mcp
Claude Code 
claude mcp add agentcite -- npx -y agentcite-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "agentcite": {
            "command": "npx",
            "args": [
                "-y",
                "agentcite-mcp@0.1.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. AgentCite
  2. API (MVP)
  3. Roadmap (build order)
  4. Guardrails
  5. Billing (Stripe)

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)

  1. ✅ Core /cite + /health (openAlex REST, no key, no binary — serverless-portable)
  2. ⏳ API-key + quota gate (Supabase: anon free tier rate-limited vs keyed Pro)
  3. ⏳ MCP server: get_citations(topic, n, since) (stdio + http) — the agent-native surface
  4. ⏳ 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.
  5. 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.

Frequently asked questions

What is io.github.Kevinx702/agentcite?

Fabrication-free, DOI-backed citations for AI agents — real openAlex sources, never hallucinated.

How do I install io.github.Kevinx702/agentcite?

It runs on your machine. In Claude Code: claude mcp add agentcite -- npx -y agentcite-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Kevinx702/agentcite need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.Kevinx702/agentcite open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.Kevinx702/agentcite?

It is published by Kevinx702. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.