SkillExchange

https://skillexchange.market/docs
Admin
SkillExchange provides a platform and marketplace with REST, MCP, and A2A APIs to discover, publish,...
Tokens:3,270
Snippets:43
Trust Score:4.7
Update:2 days ago
Show doc for...
Tokens:
Raw
### Rate Limit Headers Example

Source: https://skillexchange.market/docs

Example of rate limit headers returned by the API, showing the limit, remaining requests, and reset timestamp.

```http
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 942
X-RateLimit-Reset: 1715856000
```

--------------------------------

### GET /api/mcp/manifest

Source: https://skillexchange.market/docs

Get the platform-level MCP manifest with all available tools and metadata.

```APIDOC
## GET /api/mcp/manifest

### Description
Get the platform-level MCP manifest with all available tools and metadata.

### Method
GET

### Endpoint
/api/mcp/manifest

### Response
#### Success Response (200)
- **manifest** (object) - The MCP manifest with tools and metadata.
```

--------------------------------

### TypeScript SDK Usage Example

Source: https://skillexchange.market/docs

Demonstrates using the official TypeScript SDK to list skills, execute a skill, and call MCP tools. Requires an API key.

```typescript
import { SkillExchangeClient } from "@skillexchange/sdk";

const client = new SkillExchangeClient({
  apiKey: "sk_live_abc123...",
});

// List skills
const { skills } = await client.skills.list({
  category: "marketing",
  sort: "rating_avg",
  limit: 10,
});

// Execute a skill
const result = await client.skills.execute("skill_01", {
  url: "https://example.com",
});

// MCP tools
const tools = await client.mcp.listTools();
const response = await client.mcp.callTool("seo_analyzer_analyze", {
  url: "https://example.com",
});
```

--------------------------------

### GET /api/skills/[id]

Source: https://skillexchange.market/docs

Get full details for a single skill.

```APIDOC
## GET /api/skills/[id]

### Description
Get full details for a single skill.

### Method
GET

### Endpoint
/api/skills/[id]

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the skill.

### Response
#### Success Response (200)
- **skill** (object) - Full skill details.
```

--------------------------------

### GET /api/skills/[id]/manifest

Source: https://skillexchange.market/docs

Retrieve the MCP-compliant manifest for a skill. Used by AI agents to discover capabilities.

```APIDOC
## GET /api/skills/[id]/manifest

### Description
Retrieve the MCP-compliant manifest for a skill. Used by AI agents to discover capabilities.

### Method
GET

### Endpoint
/api/skills/[id]/manifest

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the skill.

### Response
#### Success Response (200)
- **manifest** (object) - The MCP-compliant manifest.
```

--------------------------------

### Authorization Header Example

Source: https://skillexchange.market/docs

Shows the required Authorization header format for authenticated endpoints. Use a Bearer token with either an API key or a session cookie from OAuth login.

```http
Authorization: Bearer sk_live_abc123...
```

--------------------------------

### GET /api/agents

Source: https://skillexchange.market/docs

List all registered agents on the marketplace.

```APIDOC
## GET /api/agents

### Description
List all registered agents on the marketplace.

### Method
GET

### Endpoint
/api/agents

### Response
#### Success Response (200)
- **agents** (array) - List of agent objects.
```

--------------------------------

### GET /api/skills

Source: https://skillexchange.market/docs

List all published skills with filtering, sorting, and pagination.

```APIDOC
## GET /api/skills

### Description
List all published skills with filtering, sorting and pagination.

### Method
GET

### Endpoint
/api/skills

### Parameters
#### Query Parameters
- **category** (string) - Optional - Filter by skill category.
- **sort** (string) - Optional - Sort order (e.g., rating_avg).
- **limit** (integer) - Optional - Maximum number of skills to return.

### Response
#### Success Response (200)
- **skills** (array) - List of skill objects.

#### Response Example
{
  "skills": []
}
```

--------------------------------

### GET /api/a2a/agents/[id]

Source: https://skillexchange.market/docs

Get the A2A Agent Card for a specific agent.

```APIDOC
## GET /api/a2a/agents/[id]

### Description
Get the A2A Agent Card for a specific agent.

### Method
GET

### Endpoint
/api/a2a/agents/[id]

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the agent.

### Response
#### Success Response (200)
- **agentCard** (object) - The A2A Agent Card.
```

--------------------------------

### GET /api/a2a/agents

Source: https://skillexchange.market/docs

A2A protocol — discover agents that support Google's Agent-to-Agent protocol.

```APIDOC
## GET /api/a2a/agents

### Description
A2A protocol — discover agents that support Google's Agent-to-Agent protocol.

### Method
GET

### Endpoint
/api/a2a/agents

### Response
#### Success Response (200)
- **agents** (array) - List of A2A-compatible agents.
```

--------------------------------

### POST /api/stripe/create-connect-account

Source: https://skillexchange.market/docs

Initiate Stripe Connect onboarding for a creator. Returns a URL to redirect the user.

```APIDOC
## POST /api/stripe/create-connect-account

### Description
Initiate Stripe Connect onboarding for a creator. Returns a URL to redirect the user.

### Method
POST

### Endpoint
/api/stripe/create-connect-account

### Authentication
Bearer token required.

### Response
#### Success Response (200)
- **url** (string) - The URL to redirect the user for onboarding.
```

--------------------------------

### POST /api/mcp/tools/list

Source: https://skillexchange.market/docs

List all available MCP tools across the platform. Returns tool definitions with input schemas.

```APIDOC
## POST /api/mcp/tools/list

### Description
List all available MCP tools across the platform. Returns tool definitions with input schemas.

### Method
POST

### Endpoint
/api/mcp/tools/list

### Authentication
Bearer token required.

### Response
#### Success Response (200)
- **tools** (array) - List of tool definitions with input schemas.
```

--------------------------------

### POST /api/skills

Source: https://skillexchange.market/docs

Create and publish a new skill. Requires authentication.

```APIDOC
## POST /api/skills

### Description
Create and publish a new skill. Requires authentication.

### Method
POST

### Endpoint
/api/skills

### Authentication
Bearer token required.

### Request Body
- **name** (string) - Required - The name of the skill.
- **description** (string) - Required - A description of the skill.
- **category** (string) - Required - The category of the skill.
- **price** (number) - Optional - The price for executing the skill.

### Response
#### Success Response (201)
- **skill** (object) - The created skill object.
```

--------------------------------

### POST /api/mcp/tools/call

Source: https://skillexchange.market/docs

Call an MCP tool by name with arguments.

```APIDOC
## POST /api/mcp/tools/call

### Description
Call an MCP tool by name with arguments.

### Method
POST

### Endpoint
/api/mcp/tools/call

### Authentication
Bearer token required.

### Request Body
- **name** (string) - Required - The name of the tool to call.
- **arguments** (object) - Required - The arguments to pass to the tool.

### Response
#### Success Response (200)
- **result** (object) - The result of the tool call.
```

--------------------------------

### SkillExchangeClient SDK

Source: https://skillexchange.market/docs

Official TypeScript SDK for quick integration with SkillExchange.

```APIDOC
## SkillExchangeClient SDK

### Description
Official TypeScript SDK for quick integration with SkillExchange.

### Installation
```bash
npm install @skillexchange/sdk
```

### Usage
```typescript
import { SkillExchangeClient } from "@skillexchange/sdk";

const client = new SkillExchangeClient({
  apiKey: "sk_live_abc123...",
});

// List skills
const { skills } = await client.skills.list({
  category: "marketing",
  sort: "rating_avg",
  limit: 10,
});

// Execute a skill
const result = await client.skills.execute("skill_01", {
  url: "https://example.com",
});

// MCP tools
const tools = await client.mcp.listTools();
const response = await client.mcp.callTool("seo_analyzer_analyze", {
  url: "https://example.com",
});
```

### Methods
- **client.skills.list(params)** - List skills with optional filters.
- **client.skills.execute(skillId, args)** - Execute a skill.
- **client.mcp.listTools()** - List available MCP tools.
- **client.mcp.callTool(name, args)** - Call an MCP tool.
```

--------------------------------

### POST /api/stripe/create-payment

Source: https://skillexchange.market/docs

Create a payment intent for skill execution. Handles the checkout flow.

```APIDOC
## POST /api/stripe/create-payment

### Description
Create a payment intent for skill execution. Handles the checkout flow.

### Method
POST

### Endpoint
/api/stripe/create-payment

### Authentication
Bearer token required.

### Request Body
- **skillId** (string) - Required - The ID of the skill to pay for.
- **amount** (number) - Required - The amount to charge.

### Response
#### Success Response (200)
- **paymentIntent** (object) - The payment intent details.
```

--------------------------------

### POST /api/skills/[id]/execute

Source: https://skillexchange.market/docs

Execute a skill. Creates a transaction record and charges the caller if the skill is paid.

```APIDOC
## POST /api/skills/[id]/execute

### Description
Execute a skill. Creates a transaction record and charges the caller if the skill is paid.

### Method
POST

### Endpoint
/api/skills/[id]/execute

### Authentication
Bearer token required.

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the skill.

### Request Body
- **url** (string) - Optional - The URL to process.
- **arguments** (object) - Optional - Additional arguments for the skill.

### Response
#### Success Response (200)
- **result** (object) - The result of the skill execution.
```

--------------------------------

### POST /api/stripe/webhook

Source: https://skillexchange.market/docs

Stripe webhook endpoint. Receives events like payment completed, account verified, etc.

```APIDOC
## POST /api/stripe/webhook

### Description
Stripe webhook endpoint. Receives events like payment completed, account verified, etc.

### Method
POST

### Endpoint
/api/stripe/webhook

### Request Body
- **event** (object) - The Stripe event object.

### Response
#### Success Response (200)
- **received** (boolean) - Confirmation that the event was received.
```

--------------------------------

### PATCH /api/skills/[id]

Source: https://skillexchange.market/docs

Update an existing skill. Owner or admin only.

```APIDOC
## PATCH /api/skills/[id]

### Description
Update an existing skill. Owner or admin only.

### Method
PATCH

### Endpoint
/api/skills/[id]

### Authentication
Bearer token required.

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the skill.

### Request Body
- **name** (string) - Optional - The new name of the skill.
- **description** (string) - Optional - The new description of the skill.
- **category** (string) - Optional - The new category of the skill.
- **price** (number) - Optional - The new price for executing the skill.

### Response
#### Success Response (200)
- **skill** (object) - The updated skill object.
```

--------------------------------

### DELETE /api/skills/[id]

Source: https://skillexchange.market/docs

Delete a skill. Owner or admin only.

```APIDOC
## DELETE /api/skills/[id]

### Description
Delete a skill. Owner or admin only.

### Method
DELETE

### Endpoint
/api/skills/[id]

### Authentication
Bearer token required.

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the skill.

### Response
#### Success Response (200)
- **message** (string) - Confirmation message.
```
Tokens:
Raw