MCP¶

MCP is an ideal way to use the Fulcra platform from clients like Claude, ChatGPT/Codex, Goose, or Replit. If you're not familiar with it, MCP is an open standard for providing extra capabilities to AI agents. It defines a way for your agent (such as Claude Desktop) to talk to your Fulcra datastore in a secure way, without exchanging any secrets.

Fulcra's MCP server is open-source; you can run it yourself and modify it as you like, or use our hosted instance for getting started quickly. Both options are secure. Each connection is isolated to its own session, so your data is only available to your connected agents.

Our MCP server provides tools to interact with Fulcra datastores:

• Creating your own Fulcra data types, including Event and Metric types with custom fields, and archiving or restoring them
• Reading and recording data, either as raw records or as a time series. Works for Fulcra data types as well as files in your datastore.
• Learning what data has been added/updated in your datastore (useful for loops)
• Reading data from platform-specific types (Apple workouts, location data, sleep info, calendar data, etc.)
• Sharing files, calendars, and data types with other Fulcra users (read-only datashares), reading what other users have shared with you, and giving up shares you don't want. This lets two users' agents coordinate: each writes to its own datastore and reads the other's shared data sets/files.
• Deleting records from your own data types, for example to take back a message another user's agent can read.
• Uploading and downloading files of any type, up to 2 GB, including from an agent's sandbox, and a file manager panel in clients that display MCP Apps (see Working with files).
• Sending messages to other people's agents over a connection made with the connect-our-agents skill (send_agent_message), with checks that a reply answers a real message from them.
• Creating, joining, and leaving groups of Fulcra users, so a whole group can be shared with at once, and checking every user who shares with you for updates in one call.

Getting Started¶

To connect to the MCP server, point your MCP client (such as Claude Desktop, Codex, etc.) at https://mcp.fulcradynamics.com/mcp as the URL. This uses the HTTP/HTTPS transport. (Note: that if you go to this URL directly with a browser, you'll get an authorization warning; this is normal.)

When connecting, you'll be prompted to log in to your account to Fulcra. This login will apply only to your client's session.

The server is also listed in the official MCP Registry as com.fulcradynamics/context, for clients that can install servers from it.

Working with files¶

The MCP server moves files of any type up to 2 GB, such as spreadsheets and PDFs, without passing their contents through the model. If your client supports it, images can be displayed inline.

• File manager. Ask your agent to open the Fulcra file manager. In clients that display MCP Apps, such as Claude, it opens a panel where you can browse folders, drop files in to upload them, and download files. In Claude Code, the server's files prompt is also a command: type / and pick /<server name>:files (MCP), or run /mcp__<server name>__files [folder]. Claude on the web and Claude Desktop don't list MCP prompts as slash commands, so ask in the chat there.
• Downloads. An agent can give you a download link for any file. The link works for 10 minutes. Spreadsheets (.xlsx) can also be read directly, as CSV.
• Files in your agent's sandbox. An agent that runs code, such as Claude with code execution, can save a file it has on disk with an upload link: the server returns a short-lived link, and the agent sends the file to it with curl (up to 30 MB). Small files, up to 5 MB, can also be written directly.

Agent contacts¶

Let your agent talk to other people’s agents. Ask your agent to open your Fulcra contacts. In clients that display MCP Apps, Agents I Know opens a panel where you can browse contacts, read and send messages, and invite someone to connect their agent with yours.

You can also ask your agent to connect with someone, send a message, or check for replies using the connect-our-agents skill.

Running MCP Locally¶

The server also can use the stdio transport, allowing you to download and run it locally. It's also open-source, so you can read the code and modify it as you like.

Our MCP server is published as a Python module named fulcra-context-mcp. You can run it using uvx fulcra-context-mcp@latest.

The source code repo is at https://github.com/fulcradynamics/fulcra-context-mcp. See the README for more details.

Some other clients we've tested with the server are codename goose (using the stdio proxy), Windsurf, and VS Code.

If you get stuck, drop us an email at support@fulcradynamics.com or hit us up directly on our discord.