# Omentir Agent Guide

Omentir is agent-friendly for AI operators such as Hermes, OpenClaw, Claude, Codex, Cursor, and ChatGPT. Use Omentir on behalf of a customer by asking them to create a workspace-scoped token in Settings > AI Agents.

## What You Can Do

1. Inspect workspace readiness and product context.
2. List existing discovery agents, lead groups, campaigns, and setup counts.
3. Create AI discovery agents for ICP-fit prospect discovery.
4. Create and launch LinkedIn campaigns directly, or stage them as drafts when the customer prefers to review.
5. Run a workspace-scoped dry-run readiness check before live automation.

## Base URL

https://omentir.com

## Auth

Use the customer's token in every request:

```text
Authorization: Bearer <omentir_agent_token>
```

## Recommended Workflow

1. GET /api/agent/v1/context
2. GET or PUT /api/agent/v1/product-profile to confirm the ICP and product context.
3. If LinkedIn is missing, ask the customer to connect it in Omentir.
4. POST /api/agent/v1/agents with signal sources, filters, or a prompt.
5. GET /api/agent/v1/leads to inspect discovered prospects.
6. GET /api/agent/v1/campaigns to find the right lead group.
7. POST /api/agent/v1/campaigns with status "active" to launch outreach directly, or "draft" if the customer prefers to review first.
8. POST /api/agent/v1/automation/dry-run to confirm readiness before activating.
9. GET /api/agent/v1/conversations to review replies and handoff opportunities.

## MCP-Style Tool Calling

Tool-calling agents can use:

```text
POST /api/agent/v1/mcp
Authorization: Bearer <omentir_agent_token>
```

If your client cannot send custom headers (ChatGPT or claude.ai custom
connectors), append the token as a query param instead:
`POST /api/agent/v1/mcp?key=<omentir_agent_token>`

Human-readable, client-by-client setup instructions: https://omentir.com/mcp-server

Supported JSON-RPC methods:

- initialize
- tools/list
- tools/call

Available tools:

- omentir_get_context
- omentir_get_product_profile
- omentir_update_product_profile
- omentir_list_agents
- omentir_create_agent
- omentir_pause_agent / omentir_resume_agent / omentir_delete_agent
- omentir_list_campaigns
- omentir_create_campaign
- omentir_pause_campaign / omentir_resume_campaign / omentir_delete_campaign
- omentir_update_campaign_steps (in-flight leads are re-aligned safely)
- omentir_automation_dry_run
- omentir_list_leads
- omentir_list_groups
- omentir_list_conversations
- omentir_reply_to_lead (existing conversations only; counts against the daily message quota)

## API Schema

OpenAPI JSON: https://omentir.com/api/agent/v1/openapi.json

## Guardrails

- Do not scrape or contact prospects outside the customer's stated ICP.
- Follow the customer's instructions on launching: activate directly when they want outreach running, use drafts when they want to review.
- Keep messages personalized, relevant, and respectful.
- Stop or pause if the workspace is missing profile, billing, LinkedIn, or lead readiness.