Model Context Protocol
Your knowledge, inside Claude, Cursor and ChatGPT.
Twinkle runs an MCP server, so the AI assistants you already use can search your personal knowledge base and save new things to it, without copy-paste and without leaving the conversation.
01 / In plain terms
MCP is the open protocol that lets an AI assistant reach your tools. Twinkle puts everything you’ve saved on the other end of it.
Instead of pasting notes into a chat every time, you connect Twinkle once. From then on your assistant can pull from everything you have saved and add to it as you work. Your library and your model, finally in the same place.
02 / What your assistant can do
Five actions, once you’re connected.
Twinkle exposes a small, focused set of tools any MCP client can call.
search_knowledgeSearch your library by meaning and get back the most relevant items.
search_entitiesLook up the people, places and topics in your knowledge graph.
add_itemSave something new to Twinkle from inside the conversation.
get_itemPull the full content and summary of any saved item.
list_recentSee what you saved most recently, without leaving your editor.
03 / Connect in a minute
Pick your tool and go.
MCP works the same everywhere; the setup just differs by client.
Claude Desktop
Paste URL or one-line prompt
Claude Code
claude mcp add --transport http
Cursor
One-click deep link
VS Code
One-click install
Windsurf
Paste server URL
ChatGPT
Connect via MCP
One-click for editors
Cursor and VS Code install with a single deep link. The server URL and config are filled in for you.
A line for Claude Code
Add Twinkle to Claude Code from the terminal and authorize it in the browser with OAuth.
Paste for the rest
Claude Desktop, Windsurf and ChatGPT connect by pasting the server URL, or with a personal API key.
claude mcp add --transport http \
twinkle https://gettwinkle.com/api/mcpConnected, not exposed.
Tools authorize with OAuth 2.0 and PKCE where supported, and personal API keys are hashed and shown only once. Whatever connects can only ever reach your own library, because every call is scoped to your account.
04 / Questions
MCP, answered.
What is MCP?
The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to outside tools and data. An MCP server exposes a set of actions an assistant can call. Twinkle’s MCP server exposes your knowledge base, so an assistant can search it and add to it on your behalf.
Which AI tools can connect to Twinkle?
Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and ChatGPT, plus anything else that speaks MCP. Cursor and VS Code install with one click; the others connect by pasting a URL or using a personal API key.
Do I need a paid plan to use MCP?
No. MCP access is included on every plan, including Free. You can connect your AI tools to your knowledge base from day one.
Is connecting an AI tool secure?
Yes. Twinkle uses OAuth 2.0 with PKCE for tools that support it, and personal API keys are hashed and shown only once. Either way, an assistant can only reach your own library, because every request is scoped to your account by row-level security.
What can the assistant actually do once connected?
It can search your knowledge, look up entities, read a specific item, list what you saved recently, and add new items to your library. It works with what you have saved; it does not get access to anything outside your account.
Can the assistant save things back to Twinkle?
Yes. The add_item action lets an assistant save a URL or note to your knowledge base mid-conversation. So if Claude or Cursor finds something worth keeping while you work, it can put it straight into your library.
Do I have to use OAuth, or can I use an API key?
Either. OAuth is the smoothest path for tools that support it (Cursor, VS Code, Claude Code). For anything else you can generate a personal API key and paste it. Keys are shown once, can have an expiry, and can be revoked anytime.
How is this different from pasting notes into a chat?
Pasting is manual, one-off and limited to what you remember to copy. With MCP, your whole library is available on demand: the assistant searches it itself, pulls exactly what is relevant, and can add to it, without you context-switching.
Does connecting Twinkle cost extra?
No. MCP is part of every plan at no additional cost. You only pay for storage and processing as your library grows, the same as any other Twinkle usage.