GoProfiles MCP Server

An MCP server that exposes GoProfiles as tools for AI assistants. Built with FastMCP.

Hosted HTTP Mode

This server is intended to run as a hosted remote MCP server over Streamable HTTP.

Public endpoint shape:

https://mcp.goprofiles.io/mcp

Local development endpoint shape:

http://localhost:8000/mcp

Related MCP server: KappaML MCP Server

Authentication

The hosted server does not use a shared GOPROFILES_API_TOKEN.

MCP clients should send a per-user GoProfiles OAuth/API bearer token with each request:

Authorization: Bearer YOUR_TOKEN

The MCP server forwards that header to api.goprofiles.io. GoProfiles remains responsible for token validation, scope enforcement, refresh, storage, and revocation.

An OAuth client must be pre-registered in your GoProfiles workspace with:

• Allowed scopes: (define when tools are added)

• Redirect URIs: the exact callback URL(s) your MCP client uses

Local Development

This project uses Python 3.12 and uv.

1. Install Python 3.12.

2. Install uv.

3. Create the local environment and install dependencies:

uv sync

4. Run the MCP server locally:

uv run python -m goprofiles_mcp

The server binds to 0.0.0.0:8000 by default. Override with MCP_HOST and MCP_PORT if you need a different host or port:

MCP_HOST=127.0.0.1 MCP_PORT=9000 uv run python -m goprofiles_mcp

5. Verify health and OAuth discovery:

curl http://localhost:8000/health
curl http://localhost:8000/.well-known/oauth-authorization-server

Test on ChatGPT

ChatGPT cannot reach localhost. Expose your local MCP server with a public HTTPS tunnel (ngrok), then add it as a custom connector.

1. Start the MCP server locally (see Local Development) so it is listening on port 8000.

2. Install ngrok (macOS example):

brew install ngrok

3. Sign up at ngrok.com, copy your authtoken, and configure the agent:

ngrok config add-authtoken YOUR_AUTHTOKEN

4. In a separate terminal, tunnel port 8000:

ngrok http 8000

5. Copy the HTTPS forwarding URL ngrok prints (for example https://abc123.ngrok-free.app) and append /mcp:

https://abc123.ngrok-free.app/mcp

6. Confirm the tunnel reaches your server:

curl -i https://abc123.ngrok-free.app/health

7. In ChatGPT: Settings → Connectors, enable Developer Mode, then create a connector and paste the /mcp URL from step 5.

Notes

• Keep both the MCP server and the ngrok process running while you test.

• /mcp requires a Bearer token. Full ChatGPT OAuth login needs working GoProfiles authorize/token endpoints; without that, the connector may reach the URL but fail authentication.

• This server currently has no registered tools, so a successful connect will still show an empty tool list.

Docker

Build and run locally:

docker build -t goprofiles-mcp .
docker run --rm -p 8000:8000 goprofiles-mcp

Tools

No tools are registered yet. Add modules under src/goprofiles_mcp/tools/ and register them in src/goprofiles_mcp/server.py.