io.github.kozmos-tech/contactapi MCP Server

An open-source API for collecting and managing contacts and signups. The service defines an API where you send a POST with an email and additional JSON fields, which are saved as-is, and manage records via simple CRUD.

🛠️ Key Features

Collect and manage contacts and signups
Save incoming JSON fields “as-is” via POST
CRUD-style management of saved contacts
LLM-friendly docs at /llms.txt

🚀 Use Cases

Store contact submissions (email plus extra JSON fields)
Handle signups and related contact data
Expose REST-style endpoints backed by Hono and deployed on Vercel

⚡ Developer Benefits

Built with TypeScript tooling (includes hono, vercel)
Uses an API key as a Bearer token (Authorization header)
Provides developer-facing landing page and routes (/, /login, /signup)
Includes model-context-protocol topic support metadata

⚠️ Limitations

Described only at the “contacts and signups” level; no additional API operations beyond CRUD are specified
No details are provided on schema validation, auth flows beyond Bearer token usage, or rate limits

API overview

The base URL is https://contactapi.dev and every request carries your API key as a Bearer token:

code

Authorization: Bearer YOUR_KEY

Method

Path

Key

Description

POST

/v1/contacts

secret or publishable

Create (or upsert) a contact by email

GET

/v1/contacts

secret

List contacts, paginated

GET

/v1/contacts/:id

secret

Fetch a single contact

PATCH

/v1/contacts/:id

secret

Update a contact

DELETE

/v1/contacts/:id

secret

Delete a contact

Contacts are keyed by email — creating one whose email already exists updates it in place rather than duplicating it. Full reference lives on the landing page and in /llms.txt.

There are two kinds of key:

ck_secret_… — secret key, for your backend. Full access to every endpoint.

ck_pub_… — publishable key, for the browser. Can only create contacts and is locked to your domains.

MCP server

AI clients (Claude Desktop, claude.ai custom connectors, Cursor, the MCP Inspector) can manage your contacts through an MCP server at:

code

https://contactapi.dev/mcp

Auth is OAuth 2.1 with dynamic client registration — point a client at the URL and it discovers the authorization server, registers itself, and sends you to log in and approve access; no API key to copy. The server exposes five tools that mirror the REST API: list_contacts, get_contact, create_contact (upsert-by-email), update_contact, and delete_contact. Everything is scoped to the account you log in as.

The OAuth provider is Better Auth's mcp plugin (src/auth.ts); the tools and endpoint wiring live in src/mcp/server.ts and src/index.ts.

io.github.kozmos-tech/contactapi