Skip to main content
Glama
luisruiz3012

Paid Business Data MCP Server

by luisruiz3012

Paid Business Data MCP Server

MCP server demonstrating paid x402 tools with Pyrimid Protocol integration.

Features

  • Free preview toolspreview_enriched_search, preview_competitive_analysis

  • Paid toolsbuy_enriched_search ($0.10), buy_competitive_analysis ($0.25)

  • HTTP 402 Payment Required — standard x402 flow

  • Pyrimid catalog metadata — discoverable by buyer agents

  • Groq AI enrichment — llama-3.3-70b for business intelligence

Related MCP server: x402-farm

Quick Start

npm install
node src/http-server.js

Endpoints

Endpoint

Method

Price

Description

/api/v1/health

GET

Free

Health check

/api/v1/products

GET

Free

List all paid products

/api/v1/preview/enriched-search?q=<query>

GET

Free

Preview enriched search output

/api/v1/paid/enriched-search?q=<query>

GET

$0.10

Full AI-enriched business search

/api/v1/preview/competitive-analysis

GET

Free

Preview competitive analysis

/api/v1/paid/competitive-analysis

POST

$0.25

Full competitive analysis report

x402 Payment Flow

  1. Call paid endpoint without X-PAYMENT-TX → get HTTP 402

  2. Pay USDC via PyrimidRouter on Base

  3. Retry with X-PAYMENT-TX: <tx_hash> header

  4. Receive premium data

License

MIT

Available Tools

5 tools
company_overviewC

Get a free company overview including industry, size, and description

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions the tool is 'free', which is somewhat useful, but doesn't disclose data freshness, coverage limitations, whether the info is based on live data or cached, or what happens with unknown/unlisted companies. For a data-lookup tool with no annotation coverage, more context is needed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence efficiently conveys the core purpose and what the tool returns. There's no waste or redundancy. The description is appropriately sized for a simple lookup tool with one parameter.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a one-parameter lookup tool with no output schema and no annotations, the description is somewhat sparse. It tells the agent what data comes back (industry, size, description) but doesn't address edge cases like unavailable companies or whether results vary by market. Given the tool's simplicity, this is adequate but could be enriched with error-handling or coverage notes.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter 'name' has 0% schema description coverage, but the parameter is simple and self-explanatory given the tool name. The description implies that 'name' refers to a company name but doesn't explicitly state it, nor does it clarify format expectations (e.g., full legal name vs. common name, case sensitivity). For a single scalar parameter, the baseline is modest and the description adds minimal but acceptable value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb (get) and resource (company overview) with the scope of what it returns: industry, size, and description. It's specific enough to convey the tool's purpose, though it doesn't explicitly differentiate from sibling tools like enriched_search or competitive_analysis.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. The description doesn't mention whether this should be used as a first step before competitive_analysis or financial_report, nor does it explain when a more detailed tool would be preferable. Sibling tools like market_trend or competitive_analysis have overlapping domains but no differentiation is given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

competitive_analysisC

[PAID $0.25] Full competitive landscape analysis with pricing, strengths, weaknesses, and market positioning

ParametersJSON Schema
NameRequiredDescriptionDefault
companyYes
industryNo

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions a cost of $0.25 (useful) but does not disclose latency, data freshness, coverage limitations, whether both parameters are required, or what the response structure looks like. For a paid tool, the behavioral profile is notably under-specified.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, tightly packed with content. It's efficiently worded and front-loads the tool's purpose. The [PAID] cost marker is a useful lead element. Minimal waste, though bundled concepts could arguably be expanded slightly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

This is a moderately complex analytical tool with cost implications, but no annotations, no output schema, and 0% parameter coverage. For a paid tool, an agent needs to know what the response covers (report? data table?), whether both or just one parameter is needed, and what determines the cost. The description addresses scope but leaves operational behavior and prerequisites unclear.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It does not explain what 'company' expects (name? ticker?) or what 'industry' is used for (scoping, filtering?). The description mentions pricing and market positioning, which loosely relate to the parameters, but adds no format, example, or semantic clarity to the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb ('competitive landscape analysis') with a resource (the competitor), and enumerates covered dimensions: pricing, strengths, weaknesses, and market positioning. This clearly distinguishes it from siblings like company_overview or financial_report. It doesn't explicitly name a competing alternative, but the scope is specific enough to differentiate.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit when/when-not guidance is provided. There's no mention of prerequisites, interaction with company_overview or market_trend, or scenarios where this tool should or shouldn't be chosen. The [PAID $0.25] tag hints at cost implications but doesn't clarify when the cost is justified versus free alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

financial_reportC

[PAID $0.15] Generate a financial health report with key metrics, ratios, and peer comparison

ParametersJSON Schema
NameRequiredDescriptionDefault
companyYes
fiscal_yearNo

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden for behavioral disclosure. The 'generate' verb implies this is a read/query operation that produces a report, but the description doesn't disclose whether data is cached, whether the report is real-time or snapshot-based, whether fiscal_year is required for a report, or what the pricing implication ($0.15) means for repeated/redundant calls. The cost signal is disclosed but broader behavioral context is missing.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single compact sentence that is front-loaded with the 'Generate' action and includes the cost disclosure upfront. It packs purpose and deliverable content efficiently without redundancy. The '[PAID $0.15]' prefix is additive information. Minor deduction for not leveraging the available space to clarify parameter usage.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 2-param tool with no output schema and no annotations, the description provides a reasonable core purpose but leaves operational gaps. It doesn't explain what 'peer comparison' entails, how peers are determined, whether historical fiscal_year inputs change the output, or what happens if fiscal_year is omitted. The absence of an output schema means the description should describe what the returned report contains, but it only lists high-level categories (metrics, ratios, peer comparison). Adequate but not complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate for both parameters. The description mentions 'key metrics, ratios, and peer comparison' which implies content but doesn't clarify the meaning of 'company' and 'fiscal_year' beyond their schema types (string). Notably, it doesn't clarify whether fiscal_year is optional (it's not in required) or what format it should take (e.g., '2023' vs 'FY2023'). The description adds minimal parameter meaning beyond the bare schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the verb ('Generate'), resource ('a financial health report'), and content ('key metrics, ratios, and peer comparison'). It distinguishes itself from sibling tools like company_overview and competitive_analysis by specifying the deliverable is a financial health report, though the distinction is somewhat subtle. The '[PAID $0.15]' prefix adds useful cost context not present in structured fields.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no explicit guidance on when to use this vs. alternatives. Sibling tools like company_overview and competitive_analysis could overlap with 'financial health report' functionality, but the description doesn't clarify when this tool is preferred, or when one of the others should be used instead. No exclusions or prerequisites are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

market_trendC

Get a free summary of current market trends for any sector

ParametersJSON Schema
NameRequiredDescriptionDefault
sectorYes

TDQS

C2.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. The word 'free' hints at cost or access characteristics, but there's no mention of data freshness, source, response format, or limitations. For a tool describing what it returns, it doesn't disclose what the summary contains or how comprehensive it is.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One clean, front-loaded sentence with zero waste. It efficiently conveys the core purpose, though it errs on the side of under-specification rather than genuine conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-parameter tool with no annotations, no output schema, and 0% schema coverage, the description is too thin. It doesn't explain what the summary covers, the format of results, or how to formulate the sector parameter correctly. A well-functioning tool with one parameter should be able to fully document its behavior in a few sentences, and this falls short.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, meaning the description must compensate for the undocumented 'sector' parameter. The description says 'for any sector' but doesn't clarify the expected format (company name, industry name, ticker symbol), whether free-form text is acceptable, or what constitutes a valid sector input. This is a significant gap given zero schema documentation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses specific language ('Get a free summary of current market trends for any sector') with a verb and resource, clearly indicating it retrieves trend data for sectors. However, it doesn't meaningfully differentiate from siblings like enriched_search or competitive_analysis, which could also surface market information.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives. The 'free' qualifier hints at a distinction from paid tools, but this is not explicit. There's no mention of when the agent should prefer market_trend over enriched_search or competitive_analysis.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 5 tool updatesv1.0.0
    • First observedcompany_overview
    • First observedcompetitive_analysis
    • First observedenriched_search
    • First observedfinancial_report
    • First observedmarket_trend

TDQS

B3/5.0
Disambiguation4/5

The free tools (company_overview, market_trend) and paid tools (enriched_search, competitive_analysis, financial_report) are reasonably distinct in purpose. However, enriched_search and competitive_analysis could overlap since enriched_search includes competitive analysis, potentially causing confusion about which to select for competitive needs.

Naming Consistency4/5

Tool names follow a roughly consistent noun-based pattern (company_overview, market_trend, financial_report) with two verb-style names (enriched_search, competitive_analysis) mixed in. The mixed noun/verb convention is a minor deviation but names remain readable and predictable.

Tool Count5/5

Five tools is well-scoped for a business data server. The split between free and paid tiers is clear and each tool serves a distinct purpose without bloating the surface.

Completeness3/5

The server covers overview, market trends, enriched search, competitive analysis, and financial reporting. However, gaps exist such as no tool for targeted financial data lookup (like a specific financial statement query) or industry-specific company comparisons beyond the paid search.

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server providing 10 pay-per-call APIs for web scraping, DNS, email validation, and French business data, with autonomous micropayments via the x402 protocol (USDC on Base).
    1
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server that provides AI agents with pay-per-call access to a suite of tools (honeypot check, token market, DeFi yields, etc.) via USDC on Base using the x402 protocol.
    4
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/luisruiz3012/paid-business-data-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server