MCP server

The hosted Genseo MCP server exposes allowlisted AI visibility, site health, and content tools through Streamable HTTP. ChatGPT and other marketplace clients connect with OAuth; local clients may use a project-bound API key. Start with the Genseo ChatGPT app guide if you use ChatGPT.

Endpoint

https://api.genseo.co/mcp

OAuth can list all projects available to the connected account. A chat selects one project and sends its project_id with every later tool call. API keys continue to expose only their bound project. MCP never exposes billing, project creation, project deletion, credentials, or internal database operations.

Before you connect

You need:

A Genseo account and project.
OAuth support in the client, or a project-bound API key from Project → Brand → API / Developer.
An MCP client that supports Streamable HTTP or a local stdio process.

Keep the key in environment or encrypted secret storage. Never place credentials in the MCP URL.

Claude Code

Create .mcp.json in your plugin or project configuration:

{
  "mcpServers": {
    "genseo": {
      "type": "http",
      "url": "https://api.genseo.co/mcp",
      "headers": {
        "Authorization": "Bearer ${GENSEO_API_KEY}"
      }
    }
  }
}

Set the key before starting Claude Code:

export GENSEO_API_KEY="gs_live_..."

Open /mcp and verify the genseo connection.

Codex

Use an environment-backed Bearer token:

{
  "mcpServers": {
    "genseo": {
      "type": "http",
      "url": "https://api.genseo.co/mcp",
      "bearer_token_env_var": "GENSEO_API_KEY"
    }
  }
}

Then set the key before starting Codex:

export GENSEO_API_KEY="gs_live_..."

Other MCP clients

Configure the same Streamable HTTP endpoint and send this request header from the client’s secure credential storage:

Authorization: Bearer gs_live_...

Clients that do not support remote HTTP MCP can use the local CLI server described below.

Local stdio MCP

Install the Genseo CLI globally:

npm install -g @genseo/cli

Configure the client to launch genseo-mcp:

{
  "mcpServers": {
    "genseo": {
      "command": "genseo-mcp",
      "env": {
        "GENSEO_API_BASE": "https://api.genseo.co/v1",
        "GENSEO_API_KEY": "${GENSEO_API_KEY}"
      }
    }
  }
}

Or run without a global installation:

{
  "mcpServers": {
    "genseo": {
      "command": "npx",
      "args": ["-y", "--package", "@genseo/cli", "genseo-mcp"],
      "env": {
        "GENSEO_API_BASE": "https://api.genseo.co/v1",
        "GENSEO_API_KEY": "${GENSEO_API_KEY}"
      }
    }
  }
}

Verify the connection

For OAuth-capable clients, add the remote endpoint and complete the browser sign-in described in OAuth connection. Then ask the agent:

List my Genseo projects and let me select one for this chat.

A successful connection calls genseo_me or genseo_projects_list. Select one returned Project ID and keep it fixed for the chat.

Available tools

Area	Read tools	Write tools
Account and project	`genseo_me`, `genseo_projects_list`, `genseo_project_get`	`genseo_project_update`
AI visibility	`genseo_visibility_overview`, `genseo_visibility_prompts_list`, `genseo_visibility_prompt_get`, `genseo_visibility_quota`	`genseo_visibility_prompt_create`, `genseo_visibility_prompts_create`, `genseo_visibility_prompt_archive`, `genseo_visibility_prompt_restore`, `genseo_visibility_prompt_track`
Audits and Issues	`genseo_audits_list`, `genseo_audit_current`, `genseo_site_health`, `genseo_pages_list`, `genseo_issues_list`, `genseo_issue_get`	`genseo_audit_start`, `genseo_audit_recheck`, `genseo_issue_update`, `genseo_issue_pages_update`
Opportunities	`genseo_opportunities_list`, `genseo_opportunity_get`	`genseo_opportunity_update`
Brand and Autopilot	`genseo_brand_list`, `genseo_autopilot_get`	`genseo_brand_create`, `genseo_autopilot_update`, `genseo_autopilot_bootstrap`
Keywords	`genseo_keywords_list`, `genseo_keyword_metrics`	`genseo_keywords_create`, `genseo_keywords_generate`
Posts	`genseo_posts_list`, `genseo_posts_get`	`genseo_posts_create_draft`, `genseo_posts_update`, `genseo_posts_generate`, `genseo_posts_publish`
Integrations	`genseo_integrations_list`, `genseo_integration_fields`, `genseo_integration_connect_url`	`genseo_integration_mapping_save`
Webhooks	`genseo_webhooks_list`	`genseo_webhooks_create`, `genseo_webhooks_delete`

Every tool includes a human-readable title, JSON input/output schema, structured output, OAuth metadata, and safety annotations. See the complete MCP tool reference. Removal tools are retained for project-bound API-key compatibility. OAuth-connected Autopilot calls to destructive deletion tools are rejected with action_not_available.

Required agent behavior

Call genseo_me or genseo_projects_list first.
Select one returned project and include its ID in every project tool.
Read a post before updating it.
Prefer drafts before generation or publishing.
Check integrations before publishing.
Use autonomous writes only when Agent Autonomy is enabled for the selected project.

Treat authorization and project-boundary errors as final. Back off after rate limits and treat 202 Accepted as successful queueing.

Plugin package

For an installable package containing the MCP configuration and shared Agent Skills, use the public Genseo MCP repository or follow the AI Plugins guide.

Overview

Apps

Connect

Endpoint

Before you connect

Claude Code

Codex

Other MCP clients

Local stdio MCP

Verify the connection

Available tools

Required agent behavior

Plugin package

​Endpoint

​Before you connect

​Claude Code

​Codex

​Other MCP clients

​Local stdio MCP

​Verify the connection

​Available tools

​Required agent behavior

​Plugin package

Endpoint

Before you connect

Claude Code

Codex

Other MCP clients

Local stdio MCP

Verify the connection

Available tools

Required agent behavior

Plugin package