GoOmni AgentsGoOmni/API/AI Integrations

AI Integrations

Every GoOmni API endpoint works as a tool for AI assistants. Your customers' existing AI tools (Google Antigravity, ChatGPT, Claude, or any LLM with function calling) can discover and execute all 105+ endpoints automatically. No custom code needed.

Why this matters: You give your customers one API that their AI already knows how to use, so you build the integration once. Their agent reads the tool definitions, understands what each endpoint does, and calls them on behalf of the user.

Jump to platform


Authentication

All GoOmni API endpoints require a Bearer token (JWT). Get one by signing in:

Get your token
# Sign in to get a JWT token
# Option 1: Sign in via the UI at https://agent.goomni.ai/auth/signin
#   → Copy the token from your browser session

# Option 2: Use the auth API
curl -X POST https://agent.goomni.ai/api/auth/callback/credentials \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "..."}'

# Then pass the token in every request:
# Authorization: Bearer <your-jwt-token>
Tip: When configuring MCP or ChatGPT Actions, paste your JWT token in the auth header / bearer token field. The AI agent will include it in every API call automatically.

Google Antigravity

Recommended

Agent-first IDE powered by Gemini 3

Antigravity uses MCP (Model Context Protocol) to connect AI agents to external tools. Add GoOmni as an MCP server and the agent can search knowledge bases, generate test cases, analyze websites, and call any of the 105+ endpoints, all from within the IDE.

Setup

  1. In Antigravity, click ...MCP ServersManage MCP ServersView raw config
  2. Add this to your mcp_config.json:
mcp_config.json
{
  "mcpServers": {
    "goomni": {
      "url": "https://agent.goomni.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-jwt-token>"
      }
    }
  }
}
  1. Click Refresh in the MCP Servers panel
  2. Antigravity discovers all 105+ GoOmni tools, and the agent can call them directly

Example prompts

  • "Search my knowledge base for ADA accessibility requirements"
  • "Generate QA test cases for project proj_abc123"
  • "Crawl example.com and run a Lighthouse SEO audit"
  • "Extract requirements from the uploaded RFP document"

Claude Desktop

Anthropic's desktop app with MCP support

Claude Desktop loads only command-based (stdio) MCP servers from its config file, so the url form used by other clients is skipped. Use the one-click bundle, or bridge the hosted endpoint with the mcp-remote proxy.

Option A — One-click bundle (recommended)

  1. In GoOmni, open Settings → MCP access and click Generate access key.
  2. Download GoOmni.mcpb from the same page and double-click it.
  3. Paste your access key into the field Claude shows, then click Install. No config file, no Node install.

Option B — Manual config

Requires Node.js installed. The mcp-remote proxy bridges Claude's stdio transport to the hosted GoOmni endpoint.

  1. Open ~/Library/Application Support/Claude/claude_desktop_config.json (create if it doesn't exist)
  2. Add the GoOmni MCP server:
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "goomni": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agent.goomni.ai/api/mcp",
        "--transport", "http-only",
        "--header", "Authorization: Bearer <your-jwt-token>"
      ]
    }
  }
}
  1. Fully quit and reopen Claude Desktop
  2. Claude now has access to all 105+ GoOmni tools

Cursor IDE

AI-first code editor with MCP support

Cursor supports MCP servers natively. Add GoOmni and the AI agent inside Cursor can call any endpoint while you code: search docs, generate test cases, check compliance.

Setup

  1. Open Cursor Settings → MCP → Add MCP Server
  2. Add this configuration:
MCP Server config
{
  "mcpServers": {
    "goomni": {
      "url": "https://agent.goomni.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-jwt-token>"
      }
    }
  }
}
  1. Cursor discovers all 105+ GoOmni tools
  2. Ask the agent: "Search my GoOmni knowledge base for API docs"

ChatGPT Custom GPTs

OpenAI GPT Actions

Build a Custom GPT in ChatGPT that can call all GoOmni endpoints as 'actions.' ChatGPT reads the plugin manifest, discovers the OpenAPI spec, and every endpoint becomes a callable action.

Setup

  1. Go to chat.openai.com → My GPTs → Create a GPT → Configure
  2. Scroll to Actions → click Import from URL
  3. Paste this URL:
Plugin manifest URL
https://agent.goomni.ai/.well-known/ai-plugin.json
  1. ChatGPT reads the manifest, discovers the OpenAPI spec automatically
  2. All 105+ endpoints become callable actions in your Custom GPT
  3. Set the authentication to Bearer token and paste your JWT

Google Gemini

Gemini API function calling

Use GoOmni tools with Google's Gemini models via the Gemini API or Vertex AI. Fetch tool definitions in generic format and convert to Gemini's function declaration schema.

example_gemini.py
import requests
import google.generativeai as genai

genai.configure(api_key="YOUR_GEMINI_API_KEY")

# 1. Fetch GoOmni tools in Gemini-native format
data = requests.get(
    "https://agent.goomni.ai/api/docs/ai-tools?format=gemini"
).json()

# 2. Convert to Gemini function declarations
declarations = [
    genai.protos.FunctionDeclaration(**decl)
    for decl in data["function_declarations"]
]

# 3. Create model with GoOmni tools
model = genai.GenerativeModel(
    "gemini-3-flash-preview",
    tools=[genai.protos.Tool(function_declarations=declarations)]
)

# 4. Gemini can now call GoOmni endpoints
chat = model.start_chat()
response = chat.send_message(
    "Generate QA test cases for project proj_abc123"
)
print(response.candidates[0].content.parts)

Native format: /api/docs/ai-tools?format=gemini. Also works with Vertex AI.


OpenAI Function Calling

For developers using the OpenAI API

Fetch pre-built tool definitions from GoOmni and pass them directly to openai.chat.completions.create(). The LLM decides which endpoint to call based on the user's request.

example.py
import requests
import openai

# 1. Fetch GoOmni tool definitions (105+ tools)
tools = requests.get(
    "https://agent.goomni.ai/api/docs/ai-tools?format=openai"
).json()["tools"]

# 2. Pass tools to GPT, which can now call any GoOmni endpoint
response = openai.chat.completions.create(
    model="gpt-4o",
    tools=tools,
    messages=[{
        "role": "user",
        "content": "Generate QA test cases for project proj_abc123"
    }]
)

# 3. GPT returns tool_calls → execute the HTTP request → return result
for tool_call in response.choices[0].message.tool_calls:
    print(f"Calling: {tool_call.function.name}")
    print(f"Args: {tool_call.function.arguments}")

Filter by domain: /api/docs/ai-tools?format=openai&tag=QA returns only QA-related tools.


Anthropic / Claude Function Calling

For developers using the Anthropic API

Same concept, Anthropic's tool_use format.

example.py
import requests
import anthropic

# Fetch in Anthropic format
tools = requests.get(
    "https://agent.goomni.ai/api/docs/ai-tools?format=anthropic"
).json()["tools"]

response = anthropic.messages.create(
    model="claude-sonnet-4-6",
    tools=tools,
    messages=[{
        "role": "user",
        "content": "Search the knowledge base for compliance requirements"
    }]
)

Any LLM / Custom Framework

LangChain, LlamaIndex, Gemini, or custom

Get generic tool definitions with HTTP method, path, and parameter schemas. Adapt to any framework.

Terminal
# Generic format
curl https://agent.goomni.ai/api/docs/ai-tools?format=generic

# Filter to specific domain
curl "https://agent.goomni.ai/api/docs/ai-tools?format=generic&tag=Voice"

Integration Endpoints

EndpointPurposeUsed By
POST /api/mcpMCP JSON-RPC server (tools/list, tools/call)Antigravity, Claude Desktop, Cursor
GET /api/mcpMCP server info + setup instructionsDiscovery
GET /.well-known/ai-plugin.jsonChatGPT Actions plugin manifestChatGPT Custom GPTs
GET /api/docs/ai-tools?format=openaiOpenAI function calling tool defsOpenAI API
GET /api/docs/ai-tools?format=anthropicAnthropic tool_use definitionsAnthropic API
GET /api/docs/ai-tools?format=geminiGemini function declarationsGemini API, Vertex AI
GET /api/docs/ai-tools?format=genericGeneric tool definitionsLangChain, LlamaIndex, any LLM
GET /api/docs/openapiFull OpenAPI 3.0 spec (JSON)Swagger UI, code generators
GET /api/docs/postmanPostman collection downloadPostman
/api-docsInteractive API ReferenceDevelopers