Humainum MCP

Use Humainum from your AI assistant

Connect your Humainum account to an MCP-compatible assistant. Find projects, prepare changes and follow builds from the same conversation.

Connect your account

MCP server · Streamable HTTP

https://api.humainum.com/mcp

For Thaura, Claude and other MCP clients. Available connection options depend on the client. Look for “MCP”, “Connectors” or “Add custom connector” in its settings.

Connect with your Humainum account

Use this option when your assistant supports OAuth account linking.

  1. Open the assistant’s connector settings and add a remote MCP server named Humainum.
  2. Paste the server address above, then start the connection.
  3. Sign in to Humainum. Check the application name, callback address and requested permissions before allowing access.
  4. Return to your assistant and ask it to list your Humainum projects.

Connect with an access token

Use this option if your client supports a bearer token or custom authorization header.

  1. Open Profile → Humainum MCP → Manage MCP connections.
  2. Give the connection a name, such as Thaura, and select only the permissions it needs.
  3. Create the token and save it securely. It is shown once. Do not paste it into an AI conversation.
  4. Add the server address in your client and enter the token in its authentication field. For a custom header, use Authorization: Bearer followed by your token.

You choose the permissions

  • Read your plan and credit balance.
  • Read accessible workspaces, projects and build status.
  • Create an empty project at your request.
  • Prepare a project change request and credit estimate.

Review before work starts

Preparing a change does not start a paid build. The assistant gives you a Humainum approval link, where you can review the complete request and estimated credits before starting it. Normal project permissions and billing rules apply.

Connections last 30 days. Revoke a connection at any time from Profile → Humainum MCP. If it expires, connect again. Never share one person’s token across customers.

Try these requests

  • “List my Humainum projects.”
  • “Prepare a request to change the homepage title of my project to “Hello”.”
  • “What is the current build status of my project?”

Can’t connect?

Check that your client supports remote Streamable HTTP MCP and either OAuth or bearer authentication. Use the exact server address, renew an expired connection and check its permissions. If the client has no MCP option, contact its support team.

Connection details for developers

OAuth discovery and S256 PKCE are supported. Each user connects their own account. The configuration below is an example for clients that accept bearer headers; the exact format depends on the client.

{
  "mcpServers": {
    "humainum": {
      "url": "https://api.humainum.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_TOKEN>"
      }
    }
  }
}