Skip to main content

ideon mcp serve

What This Command Does​

ideon mcp serve starts Ideon's MCP server over stdio so an MCP client can call Ideon tools.

Usage​

ideon mcp serve

Transport and Scope​

  • Transport: stdio
  • Intended use: local process-spawned MCP clients
  • Integration scope: CLI/MCP runtimes
  • Supported runtimes: claude, claude-desktop, chatgpt, gemini, codex, cursor, vscode, opencode, generic-mcp

Available Tools​

Ideon Tools​

  • ideon_write
  • ideon_write_resume
  • ideon_delete
  • ideon_links
  • ideon_config_get
  • ideon_config_set
  • ideon_config_list
  • ideon_config_unset

Google Keyword Planner Tools​

  • gkp_generate_ideas — find related keywords from seed keywords or a URL
  • gkp_get_historical_data — get historical search volume and competition for keywords
  • gkp_get_forecast_data — project impressions, clicks, and cost for keywords

The GKP tools require six Google Ads credentials to be configured before use. For setup instructions, see Google Ads Keyword Planner Setup.

Output and Exit Codes​

Exit codeMeaning
0Server exited cleanly.
1Server failed to start or encountered a runtime error.
130Command interrupted by Ctrl+C.

Versioning and Deprecation Notes​

  • Current behavior applies to Ideon 0.1.6.
  • Tool contracts are validated by the integration sync check.