.

AI Tinkerers - Developer & Agent APIs

We made this API to make the community better for members. Connect Claude, Cursor, or any MCP client and put your agents to work.

Create API keys

Sign in with your AI Tinkerers account to create Agent API keys. Key access depends on your member, attendee, or organizer eligibility.

Sign in to create keys

Documentation & Reference

Everything below is reference: overview, ideas, quickstart, endpoints, limits, and the rules.

API Overview

The AI Tinkerers Agent API lets eligible members, recent event attendees, city organizers, and their AI agents work with AI Tinkerers data programmatically: event discovery, chapter operations, RSVPs, message boards, sponsor context, jobs, public docs, and analytics, all within the same permissions available to the signed-in member on the website. Read the API Beta Terms.

City Organizers

Automate follow-ups, manage RSVPs, speaker pipelines, message boards, sponsor outreach, and chapter reporting.

Attendees

Find upcoming events, RSVP, prepare demos, follow up with people you met, and stay connected to your chapter.

Tinkerers

This is a community of AI builders. Wire the API into whatever you're hacking on and show us what happens.

What to Build

Ideas that pay off fast. Each one works as a plain-English ask once your MCP client is connected.

Sponsor pipeline agent

"Which sponsors from our last three events haven't been thanked or re-engaged? Draft follow-ups."

Post-event follow-up

"Thank yesterday's speakers, and list attendees who RSVP'd but didn't check in so I can nudge them."

Speaker scout

"Who demoed something great in nearby chapters recently that we could invite to speak next month?"

Chapter health check

"How is our RSVP and attendance trend versus last quarter? What changed?"

Event concierge

"Which upcoming events match my interests? RSVP me to the next one that fits my calendar."

People I met

"Who did I meet at last night's event? Draft a short follow-up to the two I talked demos with."

Authentication

There are two ways to authenticate, and both grant exactly the same permissions:

Authorization: Bearer sk_YOUR_KEY

OAuth connections appear in your Agent API Keys list as "OAuth: " and can be revoked there at any time, which immediately disconnects the client.

Quickstart

The fastest start is MCP. One command connects Claude Code to your chapter and community data — no API key needed, a browser window opens to sign in:

claude mcp add --transport http aitinkerers \
  https://aitinkerers.org/api/agents/mcp/v1

Run /mcp inside Claude Code to complete sign-in, then ask: "Who has RSVP'd to my next AI Tinkerers event?" Prefer a static key? Append --header "Authorization: Bearer sk_YOUR_KEY" to the command instead.

One-click connector (claude.ai, Claude Desktop, Cowork)

Settings → Connectors → Add custom connector, then paste the MCP URL and click Connect:

https://aitinkerers.org/api/agents/mcp/v1

You'll be asked to sign in to AI Tinkerers and approve the scopes. That's it.

Use MCP from Cursor or other clients

OAuth-capable clients can connect with just the URL. For clients that use static headers, add to your MCP config (mcp.json):

{
  "mcpServers": {
    "aitinkerers": {
      "url": "https://aitinkerers.org/api/agents/mcp/v1",
      "headers": { "Authorization": "Bearer sk_YOUR_KEY" }
    }
  }
}

Validate a key (curl)

curl https://aitinkerers.org/api/agents/v1/auth/validate \
  -H "Authorization: Bearer sk_YOUR_KEY"

Find upcoming events

curl https://aitinkerers.org/api/agents/v1/meetups/search \
  -H "Authorization: Bearer sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"upcoming Seattle events"}'

Read agent instructions

Start with agents.md for when-to-use guidance, safety boundaries, and recommended agent behavior.

OpenAPI

The live OpenAPI schema is public and generated from the deployed API surface.

MCP

The MCP endpoint exposes AI Tinkerers tools to compatible agent clients. Tool access is authenticated and scoped. OAuth 2.1 (authorization code + PKCE, with Dynamic Client Registration) and static bearer keys are both supported.

Rate Limits

Agent API responses include rate-limit headers such as X-RateLimit-Limit and Retry-After when throttled. Clients should use exponential backoff with jitter.

Errors

API errors are returned as structured JSON with HTTP status codes. Invalid paths return JSON guidance toward the correct /api/agents/v1 namespace.

Eligibility

Agent API access is included for eligible AI Tinkerers members, recent attendees, and city organizers. There is no public paid API plan today.

Security

Keep keys private, use the narrowest scopes possible, revoke unused keys, and never use Agent API keys for platform-internal operations.

The Rules, in Short

Your agent is you: it acts with your permissions, transparently, in ways other members would expect. Take only the data you need. Community data stays in the community. Bigger ideas are welcome, surprises are not. Our Code of Conduct applies to API usage too. Read the full API Beta Terms.

Found a security issue or exposed key? Email [email protected]. Want to build something bigger than personal or chapter tooling? Tell us first at [email protected], we say yes a lot.

Access and pricing