> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sinjapp.org/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server Setup for Sinjapp Docs

> Connect Sinjapp Business documentation to AI tools such as Claude and Cursor through the hosted Model Context Protocol server endpoint.

Sinjapp Business exposes a hosted Model Context Protocol server from the docs site.

Use this name when adding the server to AI tools:

```text theme={null}
Sinjapp Business
```

Use this URL:

```text theme={null}
https://docs.sinjapp.org/mcp
```

<Note>
  The `/mcp` path is generated by Mintlify. Do not create a page at `/mcp`; use this guide page for setup instructions.
</Note>

## What The MCP Server Provides

* Search across the Sinjapp Business documentation.
* Read full documentation pages through the docs filesystem tool.
* Access selected read-only Tenant API endpoints exposed from the OpenAPI specification.
* Use the custom `skill.md` instructions to keep product naming, scope guidance, and safety rules consistent.

## Accuracy Contract For AI Tools

When an AI tool uses this MCP server, it should:

* Use **Sinjapp Business** as the product name.
* Search the docs before answering integration questions.
* Read the exact page or OpenAPI section before giving endpoint details.
* Say when a requested endpoint, field, scope, or workflow is not documented.
* Keep tenant API keys server-side and avoid exposing them in browser-only or mobile code.
* Treat message sending, sender-number registration, API key creation, and API key revocation as side-effectful actions.

It should not:

* Invent SDK packages, dashboard paths, webhook events, rate limits, or response fields.
* Call the product `TGO Business` unless quoting legacy content.
* Use `/mcp` as a normal docs page. It is a generated MCP endpoint.

## Claude

1. Open Claude settings.
2. Go to **Connectors**.
3. Select **Add custom connector**.
4. Use `Sinjapp Business` as the name.
5. Use `https://docs.sinjapp.org/mcp` as the URL.

## Claude Code

```bash theme={null}
claude mcp add --transport http "Sinjapp Business" https://docs.sinjapp.org/mcp
```

Check that the server is available:

```bash theme={null}
claude mcp list
```

## Cursor

Add this to your Cursor MCP configuration:

```json theme={null}
{
  "mcpServers": {
    "Sinjapp Business": {
      "url": "https://docs.sinjapp.org/mcp"
    }
  }
}
```

## VS Code

Add this to `.vscode/mcp.json`:

```json theme={null}
{
  "servers": {
    "Sinjapp Business": {
      "type": "http",
      "url": "https://docs.sinjapp.org/mcp"
    }
  }
}
```

## Kiro

Kiro can load MCP servers from a workspace config file:

```text theme={null}
.kiro/settings/mcp.json
```

Or from a user-level config file:

```text theme={null}
~/.kiro/settings/mcp.json
```

Add this configuration:

```json theme={null}
{
  "mcpServers": {
    "Sinjapp Business": {
      "url": "https://docs.sinjapp.org/mcp"
    }
  }
}
```

In an active Kiro session, use `/mcp` to view loaded MCP servers and tools.

## API Tools

The MCP server exposes only read-only or lookup Tenant API operations by default:

| Tool                      | Endpoint               | Scope              |
| ------------------------- | ---------------------- | ------------------ |
| `get-tenant-context`      | `GET /me`              | Any active API key |
| `get-tenant-subscription` | `GET /subscription`    | Any active API key |
| `list-sender-numbers`     | `GET /sender-numbers`  | Any active API key |
| `lookup-contact`          | `GET /contacts/lookup` | `contacts.lookup`  |
| `list-message-logs`       | `GET /messages`        | `messages.read`    |
| `get-usage`               | `GET /usage`           | `usage.read`       |

Message sending and credential creation are not exposed as MCP tools by default. Keep those operations in your backend integration where you control approvals, audit logs, and API key storage.

## Recommended Test Prompts

Use these prompts after deployment to check answer quality:

```text theme={null}
What is the correct base URL for a Sinjapp Business tenant?
```

```text theme={null}
How do I check whether a recipient can receive messages?
```

```text theme={null}
Which scopes do I need to send messages and read message logs?
```

```text theme={null}
Why is a sender number stuck in pending_account_verification?
```

```text theme={null}
Show me a PHP example for sending an image message.
```