01 // STREAMABLE HTTP MCP

Real-world data.Right inside Grok.

Find Reddit discussions, shops, suppliers and local businesses. Connect once. Start free. No technical setup.

Set up Reddit search in Grok Bot

Get Free key (50/mo)Paid plans

MAX_RESULTS: 25COMPACT JSON

4 tools

Businesses, Stores, Suppliers, Reddit

1 to 25

Bounded compact records per call

0 charge

On discovery, failed or canceled calls

SHA-256

One-time raw key, hashed at rest

02 // PROTOCOL & PAYLOAD INSPECTOR

Ask. Receive records.

Four tools, bounded responses. Search public data and receive structured fields your agent can use.

Businesses

find_businesses

Find businesses by category and location, with addresses, websites, phone numbers and ratings. A search still running after 45 seconds returns status running and a job_id; call get_result to collect it.

Find 10 coffee shops in Boston with websites and ratings.

Returns records and count. Record fields: name, website, phone, address, latitude, longitude, rating. Unavailable values may be null.

tools/call -> find_businesses200 OK · bounded

{
  "records": [
    {
      "name": "Beacon Hill Roasters",
      "website": "https://beaconroasters.example.org",
      "phone": "+1 617-555-0148",
      "address": "84 Charles St, Boston, MA 02114",
      "latitude": 42.3588,
      "longitude": -71.0707,
      "rating": 4.8
    }
  ],
  "count": 1
}

Shopify stores

find_shopify_stores

Find Shopify stores by product niche and country served, with websites and available business contacts. A search still running after 45 seconds returns status running and a job_id; call get_result to collect it.

Find 10 outdoor equipment Shopify stores serving Germany.

Returns records and count. Record fields: name, website, domain, email, phone, city, country, rating. Unavailable values may be null.

tools/call -> find_shopify_stores200 OK · bounded

{
  "records": [
    {
      "name": "AlpenTrail Equipment",
      "website": "https://alpentrail.example.org",
      "domain": "alpentrail.example.org",
      "email": "[email protected]",
      "phone": null,
      "city": "Munich",
      "country": "DE",
      "rating": 4.7
    }
  ],
  "count": 1
}

Suppliers

find_suppliers

Find industrial suppliers by product, material or service, with company descriptions and business contacts. A search still running after 45 seconds returns status running and a job_id; call get_result to collect it.

Find 10 industrial valve suppliers with company descriptions.

Returns records and count. Record fields: name, website, phone, description, city, region, country. Unavailable values may be null.

tools/call -> find_suppliers200 OK · bounded

{
  "records": [
    {
      "name": "RheinValve Armaturen GmbH",
      "website": "https://rheinvalve.example.org",
      "phone": "+49 211 5550190",
      "description": "Manufacturer of stainless steel globe, check and cryogenic shut-off valves.",
      "city": "Dusseldorf",
      "region": "NRW",
      "country": "DE"
    }
  ],
  "count": 1
}

Reddit discussions

search_reddit

Search Reddit posts or comments by keywords, with text excerpts, links and scores. Use quotes for an exact phrase, for example "app pricing"; unquoted words may match separate parts of a post. Use subreddit without r/. Sort new prioritizes recency; relevance prioritizes matching. text_truncated means the excerpt omits part of the text. A limited sample does not establish that other relevant discussions are absent. A search still running after 45 seconds returns status running and a job_id; call get_result to collect it.

Find 10 recent Reddit posts about inventory software.

Returns records and count. Record fields: title, text, url, text_truncated, subreddit, author, score, created_at, type. Unavailable values may be null.

tools/call -> search_reddit200 OK · bounded

{
  "records": [
    {
      "title": "Moving past spreadsheets at 4,000 SKUs: lessons after six months",
      "text": "Cycle counts and barcode receiving mattered more than ERP bells and whistles.",
      "url": "https://www.reddit.com/r/supplychain/comments/example1",
      "text_truncated": false,
      "subreddit": "supplychain",
      "author": "warehouse_ops",
      "score": 142,
      "created_at": "2026-10-24T16:12:09Z",
      "type": "post"
    }
  ],
  "count": 1
}

AGENT ONBOARDING

Paste into your AI assistant

Copy this single-block briefing into Claude, ChatGPT, Cursor or any coding agent so it ingests /llms.txt, configures the MCP connection and chooses the right tool parameters.

View llms.txt

Help me connect and use fieldlookup (https://fieldlookup.com), a remote streamable HTTP MCP service with bounded public business and community data tools. Read https://fieldlookup.com/llms.txt first (fallback: https://fieldlookup.com/docs) for full input constraints, return fields, quotas and authentication. MCP endpoint: https://fieldlookup.com/mcp using header "Authorization: Bearer YOUR_API_KEY" (or OAuth 2.1 S256 PKCE, which can also create a Free account at consent). Available tools (1 to 25 compact records per call, default 10): find_businesses(query, max_results?, location), find_shopify_stores(query, max_results?, country?), find_suppliers(query, max_results?), search_reddit(query, max_results?, subreddit?, sort?, content_type?). If a call returns status running, call get_result(job_id) until it returns the records. Ask what I want to look up or which MCP client I use, keep raw API keys out of chat when a local config file or secret store is available, and configure or call the matching tool.

Machine-readable reference: https://fieldlookup.com/llms.txt

04 // CLIENT CONFIGURATION

Connect your client

Get an instant Free key or purchase a paid plan. These are setup examples for MCP clients that support remote streamable HTTP; compatibility with specific clients or versions has not been tested.

MCP URL: https://fieldlookup.com/mcp · Authentication: Authorization: Bearer YOUR_API_KEY. Keep keys out of shared configuration and version control.

Claude Code

claude mcp add --transport http public-data https://fieldlookup.com/mcp --header 'Authorization: Bearer YOUR_API_KEY'

Run in your shell with your key substituted.

Claude Desktop

For Desktop configurations that launch local MCP servers, add this to your MCP configuration. This optional bridge needs Node.js and downloads the third-party mcp-remote package when run.

{
  "mcpServers": {
    "public-data": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://fieldlookup.com/mcp",
        "--header",
        "Authorization: Bearer ${API_KEY}"
      ],
      "env": {
        "API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Where remote connectors are available, add the MCP URL in the client and sign in with OAuth.

Cursor

Add to your MCP configuration, for example .cursor/mcp.json:

{
  "mcpServers": {
    "public-data": {
      "url": "https://fieldlookup.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Generic MCP client

{
  "transport": "streamable-http",
  "url": "https://fieldlookup.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

This is a transport description; adapt field names to your client. OAuth clients can discover the authorization server from the MCP resource metadata, register dynamically and use authorization code with S256 PKCE.

OAuth 2.1 authorization is available for every plan. The client sends you to this service for consent; enter your API key only there, or create a Free account on the same page. Client versions differ; see authentication details.

05 // TRANSPARENT ALLOWANCES

Pricing

One successful tool call counts as one call, including a search that returns no records. Up to 25 records per call.

Free

USD 0 / mo

50 calls UTC calendar month

· Instant Turnstile signup, no card
· Separate from paid quota after upgrade
· Bearer header authentication

Get Free key

StarterPopular

USD 19 / mo

500 calls per subscription period

· OAuth 2.1 + S256 PKCE enabled
· Optional USD 0.05 overage cap
· Default hard stop at 0 extra calls

Choose Starter

Pro

USD 49 / mo

2,000 calls per subscription period

· Higher volume for multi-agent teams
· OAuth 2.1 + shared customer key pool
· Optional USD 0.05 overage cap

Choose Pro

Occasional use? Add credit when you need it.

$5, $10 or $25. Credit never expires. Currently $0.05 per search after your included allowance. No subscription or automatic recharge.

Ask your connected AI to add credit, or sign in to your account. Your connection stays the same.

Monthly plans in USD
Plan	Monthly price	Included calls	Start
Free	USD 0	50	Get Free key
Starter	USD 19	500	Choose Starter
Pro	USD 49	2,000	Choose Pro

Free resets each UTC calendar month. Paid allowances reset each subscription period. Free and paid allowances remain separate.

Paid overage: USD 0.05 per call beyond the included allowance, only when enabled with an additional call cap. The default is zero additional calls. Maximum additional cap: 5,000 calls per period.

Free: 50 calls/month, instant key, no card.

Prices in USD, exclusive of VAT. VAT is added where applicable and shown at checkout and on the invoice. EU business customers with a valid VAT ID are invoiced under the reverse-charge procedure.

Start a paid plan

Checkout opens on Stripe. Save the session ID and claim token before continuing. After payment, enter them on the return page to receive your API key once.

Use Checkout without JavaScript

After accepting the Terms, POST JSON to /billing/checkout, for example {"plan":"starter","overage_limit":0,"accept_terms":true}. Save the returned session_id and claim_token, then open checkout_url. After payment, POST the saved pair to /billing/claim. Save api_key immediately; it is returned once. If payment confirmation is pending, retry the same pair shortly.

For personal and business use. Read the Terms and Privacy policy before payment.

06 // OPERATIONAL FAQ

Questions

Quota rules, spend caps, data freshness and subscription cancellation.

What counts toward my allowance?

Each successful tool call counts once, even with zero matches. Discovery and failed calls do not consume the successful-call allowance. Rate limits still apply to attempts.

Can I control overage?

Yes. Paid Checkout defaults to zero additional calls. Choose a cap up to 5,000 additional calls per billing period. Calls stop at the included allowance plus your cap.

Are results complete or verified?

No. Public data can be missing, outdated or inaccurate. Check important details and use any business contact data lawfully.

How do I cancel?

Contact support to request cancellation at the end of your current period. There is no self-service cancellation portal on this site.