api-gateway

Files (200)

• CONTRIBUTING.md
• LICENSE
• README.md
• SKILL.md
• README.md · references/active-campaign/
• README.md · references/acuity-scheduling/
• README.md · references/airtable/
• README.md · references/apify/
• README.md · references/apollo/
• README.md · references/asana/
• README.md · references/attio/
• README.md · references/basecamp/
• README.md · references/baserow/
• README.md · references/beehiiv/
• README.md · references/box/
• README.md · references/brave-search/
• README.md · references/brevo/
• README.md · references/buffer/
• README.md · references/cal-com/
• README.md · references/calendly/
• README.md · references/callrail/
• README.md · references/chargebee/
• README.md · references/clickfunnels/
• README.md · references/clicksend/
• README.md · references/clickup/
• README.md · references/clio/
• README.md · references/clockify/
• README.md · references/coda/
• README.md · references/cognito-forms/
• README.md · references/companycam/
• README.md · references/confluence/
• README.md · references/constant-contact/
• README.md · references/dropbox-business/
• README.md · references/dropbox/
• README.md · references/elevenlabs/
• README.md · references/eventbrite/
• README.md · references/exa/
• README.md · references/facebook-page/
• README.md · references/fal-ai/
• README.md · references/fathom/
• README.md · references/firebase/
• README.md · references/firecrawl/
• README.md · references/fireflies/
• README.md · references/front/
• README.md · references/getresponse/
• README.md · references/github/
• README.md · references/google-ads/
• README.md · references/google-analytics-admin/
• README.md · references/google-analytics-data/
• README.md · references/google-apps-script/
• README.md · references/google-bigquery/
• README.md · references/google-calendar/
• README.md · references/google-classroom/
• README.md · references/google-contacts/
• README.md · references/google-docs/
• README.md · references/google-drive/
• README.md · references/google-forms/
• README.md · references/google-mail/
• README.md · references/google-meet/
• README.md · references/google-merchant/
• …and 140 more

SKILL.md (first lines)

# API Gateway

Managed API routing for third-party services, provided by [Maton](https://maton.ai). Use this only for a user-requested app, account, and task.

## Quick Start

**CLI:**

```bash
maton slack channel list --types public_channel --limit 10
```

```bash
maton api '/slack/api/conversations.list?types=public_channel&limit=10'
```

**Python:**

```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/slack/api/conversations.list?types=public_channel&limit=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

## Routing

Use `https://api.maton.ai/` with the app-prefixed routes documented in the examples below or in the matching reference file.

**Usage protocol:**
1. Only invoke after the user specifies the exact app, account, and task.
2. Always start with read-only (GET) calls to verify the target account, resource identifiers, and current state.
3. **All non-GET requests are denied unless the user explicitly approves each one.** Before any POST, PUT, PATCH, or DELETE call, present the user with: the exact connection ID, the full endpoint path, the request body, and the expected outcome — then wait for approval.
4. If the user's request implies a non-GET operation, first show them what you intend to call and ask for confirmation. Do not infer approval from the original request.

Read-only route examples:

```text
https://api.maton.ai/slack/api/conversations.list?types=public_channel&limit=10
https://api.maton.ai/google-mail/gmail/v1/users/me/messages
```

The first path segment is the app identifier listed in Supported Services. For Gmail, use `/google-mail/gmail/v1/users/me/messages`.

## Installation

**NPM:**
```bash
npm install -g @maton-ai/cli
```

**Homebrew:**
```bash
brew install maton-ai/cli/maton
```

## Authentication

**IMPORTANT — Credential Safety:**
- Treat `MATON_API_KEY` as a secret. Never log it, echo it, paste it into prompts, or expose it in shared files, command output, or tool results.
- **Connection creation requires explicit user approval.** Before creating any connection, ask the user to confirm the specific service and confirm they intend to authorize access. Never create connections on the agent's own initiative.
- **Least-privilege scopes:** When a service offers scope selection during OAuth, select only the scopes the current task requires. Do not accept broader scopes for convenience.
- Remove connections immediately after the task is complete if they are no longer needed (`maton connection delete {id}`).
- If the key may have been exposed (logs, screenshots, shared terminals), rotate it immediately at [maton.ai/settings](https://maton.ai/settings).
- Never share the key across users, workflows, or environments that do not require it.

**CLI:**

```bash
maton login                          # Opens browser for API key
maton login --interactive            # Skip browser, paste API key directly
maton whoami                         # Show current auth state
```

**Manual:**

1. Sign in or create an account at [maton.ai](https://maton.ai)
2. Go to [maton.ai/settings](https://maton.ai/settings)
3. Click the copy button on the right side of API Key section to copy it
4. Set your API key as `MATON_API_KEY`:

```bash
export MATON_API_KEY="YOUR_API_KEY"
```

## Connection Management

Connection management uses a separate base URL: `https://api.maton.ai`

### List Connections

**CLI:**

```bash
maton connection list slack --status ACTIVE
```

```bash
maton api -X GET /connections -f app=slack -f status=ACTIVE
```

**Python:**

```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections?app=slack&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

**Query Parameters (optional):**
- `app` - Filter by service name (e.g., `slack`, `hubspot`, `salesforce`)
- `status` - Filter by connection status (`ACTIVE`, `PENDING`, `FAILED`)

**Response:**

From zhouguoqing/QianYuan.AIAgenticFramework, Apache-2.0.

More from zhouguoqing/QianYuan.AIAgenticFramework