菜单
Use this skill when working with the Pax8 MCP tools - available tools, parameters, pagination, sorting, filtering, rate limiting, error handling, and best practices. Covers the official hosted MCP server connection and all 15 Pax8 MCP tools.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Atlas architect: boot the workspace. Verify claude-mem and context-mode, scan the project, recommend tooling (confirm first), wire hooks, seed the docs/ SSOT.
Measure atlas's own run health, audit context/asset waste, and mine session transcripts. Three lenses: RUN HEALTH reads the observability DB for metrics (wall-clock, dispatches, verifier coverage) and baseline->target goals; ASSET AUDIT scores each context-loaded skill/agent/plugin by token cost and relevance to flag disable/relocate; SESSION FORENSICS mines transcripts for unused tools and unverified claims into rules. No args reports trends.
Use to map a codebase into feature-grouped flowcharts, find architectural duplication across features, and propose the simplest unified architecture - discovery-first and zero-arg. Runs as a Workflow that fans out one explorer per feature, hunts duplication, and synthesizes a unification proposal with file:line evidence. Use before a refactor, to "find the ideal path," or to unify duplicated systems.
Generate or improve a company-specific data analysis skill by extracting tribal knowledge from analysts. BOOTSTRAP MODE - Triggers: "Create a data context skill", "Set up data analysis for our warehouse", "Help me create a skill for our database", "Generate a data skill for [company]" -> Discovers schemas, asks key questions, generates initial skill with reference files ITERATION MODE - Triggers: "Add context about [domain]", "The skill needs more info about [topic]", "Update the data skill with [metrics/tables/terminology]", "Improve the [domain] reference" -> Loads existing skill, asks targeted questions, appends/updates reference files Use when data analysts want Claude to understand their company's specific data warehouse, terminology, metrics definitions, and common query patterns.
QA an analysis before sharing with stakeholders - methodology checks, accuracy verification, and bias detection. Use when reviewing an analysis for errors, checking for survivorship bias, validating aggregation logic, or preparing documentation for reproducibility.
Build self-contained interactive HTML dashboards with Chart.js, dropdown filters, and professional styling. Use when creating dashboards, building interactive reports, or generating shareable HTML files with charts and filters that work without a server.
| name | pax8-api-patterns |
| description | Use this skill when working with the Pax8 MCP tools - available tools, parameters, pagination, sorting, filtering, rate limiting, error handling, and best practices. Covers the official hosted MCP server connection and all 15 Pax8 MCP tools. |
| when_to_use | When working with available tools, parameters, pagination, sorting, filtering, rate limiting, error handling, and best practices in the Pax8 MCP tools |
| triggers | ["pax8 api","pax8 query","pax8 filter","pax8 pagination","pax8 rate limit","pax8 authentication","pax8 mcp","pax8 endpoint","pax8 request","pax8 token","pax8 tools"] |
Pax8 provides a first-party hosted MCP server at https://mcp.pax8.com/v1/mcp for AI tool integration. The MCP server exposes 15 tools covering companies, products, subscriptions, orders, invoices, usage, and quotes. This skill covers MCP server connection, the complete tool reference, pagination patterns, sorting, error handling, and best practices.
Pax8 hosts an official MCP server. Authentication uses a single token:
MCP Server URL: https://mcp.pax8.com/v1/mcp
Required Header:
| Header | Value | Description |
|---|---|---|
x-pax8-mcp-token | <token> | MCP token from Pax8 portal |
export PAX8_MCP_TOKEN="your-mcp-token"
{
"mcpServers": {
"pax8": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.pax8.com/v1/mcp",
"--header", "x-pax8-mcp-token:YOUR_TOKEN"
]
}
}
}
| Tool | Description | Parameters |
|---|---|---|
pax8-list-companies | List and filter companies | page, size, sort (name/city/country/stateOrProvince/postalCode), order (asc/desc), company_name, status (active/inactive/deleted) |
pax8-get-company-by-uuid | Get a single company | uuid (required) |
| Tool | Description | Parameters |
|---|---|---|
pax8-list-products | Search the product catalog | productName, page, size, vendorName, search |
pax8-get-product-by-uuid | Get a single product | productId (required) |
pax8-get-product-pricing-by-uuid | Get product pricing | productId (required), companyId (optional) |
| Tool | Description | Parameters |
|---|---|---|
pax8-list-subscriptions | List and filter subscriptions | page, size, sort, status (Active/Cancelled/PendingManual/PendingAutomated/PendingCancel/WaitingForDetails/Trial/Converted/PendingActivation/Activated), billingTerm (monthly/annual/two-year/three-year/one-time/trial/activation), companyId, productId |
pax8-get-subscription-by-uuid | Get a single subscription | uuid (required) |
| Tool | Description | Parameters |
|---|---|---|
pax8-list-orders | List orders | page, size, companyId |
pax8-get-order-by-uuid | Get a single order | uuid (required) |
| Tool | Description | Parameters |
|---|---|---|
pax8-list-invoices | List and filter invoices | page, size, sort, status (unpaid/paid/void/carried/nothing due), invoiceDate, invoiceDateRangeStart, invoiceDateRangeEnd, dueDate, total, balance, carriedBalance, companyId |
pax8-get-invoice-by-uuid | Get a single invoice | uuid (required) |
| Tool | Description | Parameters |
|---|---|---|
pax8-get-usage-summary | Get usage summary for a subscription | subscriptionId (required), page, size, sort, resourceGroup, companyId |
pax8-get-detailed-usage-summary | Get detailed usage data | usageSummaryId (required), usageDate, page, size |
| Tool | Description | Parameters |
|---|---|---|
pax8-list-quotes | List and filter quotes | page, limit, sort, search, status (accepted/closed/declined/draft/expired/pending/sent) |
pax8-get-quote-by-uuid | Get a single quote | quoteId (required) |
All list tools use zero-based page pagination with configurable page size:
Pagination Parameters:
| Parameter | Description | Default | Max |
|---|---|---|---|
page | Page number (0-based) | 0 | - |
size | Results per page | 50 | 200 |
Pagination Response Metadata:
| Field | Description |
|---|---|
page.size | Number of results per page |
page.totalElements | Total number of records |
page.totalPages | Total number of pages |
page.number | Current page number (0-based) |
To fetch all results, call the list tool repeatedly, incrementing page from 0 until page.number >= page.totalPages - 1:
page=0 and size=200page.totalPages in the responsepage=1, then page=2, etc.content arrays from each responseUse the sort parameter on list tools. The order parameter specifies direction:
| Parameter | Values | Description |
|---|---|---|
sort | Varies by tool | Field to sort by |
order | asc, desc | Sort direction |
Company sort fields: name, city, country, stateOrProvince, postalCode
To list companies sorted by name ascending:
pax8-list-companies with sort=name, order=asc, size=200Each list tool supports specific filter parameters:
| Tool | Filter Parameters |
|---|---|
pax8-list-companies | company_name, status (active/inactive/deleted) |
pax8-list-products | productName, vendorName, search |
pax8-list-subscriptions | companyId, productId, status, billingTerm |
pax8-list-orders | companyId |
pax8-list-invoices | companyId, status, invoiceDate, invoiceDateRangeStart, invoiceDateRangeEnd, dueDate, total, balance, carriedBalance |
pax8-list-quotes | search, status |
| Status | Description |
|---|---|
Active | Subscription is live and billing |
Cancelled | Subscription has been terminated |
PendingManual | Awaiting manual provisioning |
PendingAutomated | Automated provisioning in progress |
PendingCancel | Cancellation in progress |
WaitingForDetails | Additional information needed |
Trial | Free trial active |
Converted | Trial converted to paid |
PendingActivation | Activation pending |
Activated | Recently activated |
| Status | Description |
|---|---|
unpaid | Invoice issued, payment not received |
paid | Invoice has been paid |
void | Invoice has been voided |
carried | Balance carried forward |
nothing due | No payment required |
Single Resource:
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Acme Corporation",
"address": {
"street": "123 Main St",
"city": "Springfield",
"stateOrProvince": "IL",
"postalCode": "62704",
"country": "US"
},
"phone": "555-123-4567",
"website": "https://www.acme.com",
"status": "Active",
"billOnBehalfOfEnabled": false,
"selfServiceAllowed": false,
"orderApprovalRequired": false,
"createdDate": "2024-01-15T10:30:00.000Z"
}
Paginated Collection:
{
"page": {
"size": 50,
"totalElements": 237,
"totalPages": 5,
"number": 0
},
"content": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Acme Corporation"
}
]
}
| Metric | Limit |
|---|---|
| Successful calls per minute | 1000 |
When rate limited, the MCP tool will return an error. Wait before retrying. The MCP server handles authentication automatically, so rate limit responses are the main error to watch for.
| Error | Cause | Resolution |
|---|---|---|
| Tool not found | MCP server not connected | Verify MCP token and server URL |
| Invalid UUID | Malformed resource ID | Check UUID format |
| Resource not found | ID does not exist | Verify the resource UUID |
| Rate limited | Too many requests | Wait 60 seconds and retry |
| Invalid parameter | Wrong filter value | Check allowed values for the parameter |
https://mcp.pax8.com/v1/mcppax8-list-companies with size=1 to verify connectivitysize=200 to minimize total tool calls when fetching all recordssort=name, order=asc for predictable pagination resultscompanyId when checking a specific client's datapax8-list-products supports a search parameter for flexible text matching