Fulcra Context MCP

🚀 fulcra-context-mcp: An MCP server to access your Fulcra Context data

This MCP server offers tools and resources to call the Fulcra API using the fulcra-api library.

🚀 Quick Start

This is an MCP server that provides tools and resources to call the Fulcra API using fulcra-api.

There is a public instance of this server running at https://mcp.fulcradynamics.com/mcp. To get started quickly, refer to https://fulcradynamics.github.io/developer-docs/mcp-server/. This repository is mainly for users who need to run the server locally, want to explore its inner workings, or wish to contribute.

When run independently (or when FULCRA_ENVIRONMENT is set to stdio), it functions as a local MCP server using the stdio transport. Otherwise, it operates as a remote server using the Streamble HTTP transport. It manages the OAuth2 callback without exposing the exchanged tokens to MCP clients. Instead, it maintains a mapping table and runs its own OAuth2 service among MCP clients.

✨ Features

• Dual Transport Modes: Supports both local stdio transport and remote Streamble HTTP transport.
• Secure OAuth2 Handling: Manages OAuth2 callbacks without leaking tokens to clients.

💻 Usage Examples

Remote Connection using Proxy

Claude for Desktop config:

{
    "mcpServers": {
        "fulcra_context": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://mcp.fulcradynamics.com/mcp"
            ]
        }
    }
}

Local Connection

Similar config using uvx:

{
    "mcpServers": {
        "fulcra_context": {
            "command": "uvx",
            "args": [
                "fulcra-context-mcp@latest"
            ]
        }
    }
}

Debugging

• Both the MCP Inspector and mcp-remote tools can be useful in debugging.

📚 Documentation

For more detailed information, please visit https://fulcradynamics.github.io/developer-docs/mcp-server/.

🐞 Bugs / Feature Requests

Please feel free to reach out via the GitHub repo for this project or join our Discord to reach out directly. Email also works (support@fulcradynamics.com).