Business Documentation
Everything you need to publish and manage verified product data on Toneeto.
Quick Start
1. Create an account — Sign up at toneeto.com/signup with your work email.
2. Claim your domain — Go to your dashboard and enter your product's domain. We'll give you a verification token.
3. Verify ownership — Add the token as:
- A DNS TXT record at
_toneeto-verify.yourdomain.com, or - An HTTPS file at
https://yourdomain.com/.well-known/toneeto-verify, or - Verify via your work email (
you@yourdomain.com)
"We raised our Pro plan from $29 to $39/month and added Salesforce import."
Toneeto structures this into verified claims automatically.
Change Object Structure
Structure:
{
"publisher": { "domain": "yourproduct.com", "display_name": "Your Product" },
"offerings": [{
"name": "Your Product",
"plans": [
{ "name": "Free", "price_monthly": 0, "is_free_tier": true },
{ "name": "Pro", "price_monthly": 39, "currency": "USD" }
],
"assets": [{ "name": "Salesforce Import", "is_new": true }],
"segments": [{ "audience_type": "small_teams", "fit_score": 0.85 }],
"gotchas": [{ "summary": "No free tier API access", "severity": "medium" }]
}],
"claims": [...],
"metadata": { "trust_score": 0.87, "evidence_count": 5 }
}
Every field is optional except publisher.domain. Start small and add detail over time.
Domain Verification
Methods (in order of trust level):
| Method | Trust Level | How |
| HTTPS file | Highest | Place token at /.well-known/toneeto-verify |
| DNS TXT | High | Add TXT record at _toneeto-verify.domain.com |
| Work email | Medium | Verify via you@domain.com email code |
- Tier 0: Unverified — data from pipeline only
- Tier 1: Email verified — basic access
- Tier 2: DNS/HTTPS verified — full publishing, disputes priority
- Tier 3: Multi-method verified — highest trust, premium features
- Tier 4: API-connected — real-time data feed (coming soon)
API Reference
Base URL: https://api.toneeto.com/v1
Authentication: Include your API key in the Authorization header:
Authorization: Bearer your-api-key
Key endpoints:
| Method | Path | Description |
| POST | /publishers/register | Register a new business |
| POST | /domains/claim | Claim a domain |
| POST | /domains/{domain}/submit/text | Submit text correction |
| POST | /domains/{domain}/submit/url | Submit URL for extraction |
| POST | /domains/{domain}/submit/promotion | Submit a promotion |
| GET | /public/{domain}/profile | Get public domain profile |
| POST | /disputes | File a data dispute |
curl -X POST https://api.toneeto.com/v1/domains/yourproduct.com/submit/text \
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{"text": "We raised our Pro plan from $29 to $39/month"}'
MCP Server
Available tools:
get_profile— Get full product profile for a domainget_claims— Get verified claims, sorted by confidencesearch_domains— Search products by keywordsubmit_correction— Submit a data correction (requires API key)file_dispute— Dispute incorrect data (no auth needed)
# For Claude Desktop / Cursor:
python -m mcp.server# For HTTP clients:
python -m mcp.server --http :8002
Claude Desktop config:
{
"mcpServers": {
"toneeto": {
"command": "python",
"args": ["-m", "mcp.server"],
"env": { "TONEETO_API_URL": "https://api.toneeto.com" }
}
}
}
See the MCP integration page for detailed setup instructions.
How Enrichment Works
Intelligence sources:
What gets enriched:
- Audience segments with fit scores and reasoning
- Decision frameworks (choose if / avoid if)
- Gotchas and hidden limitations
- Competitor comparisons
- Switching signals for migrating users
Trust & Scoring
Claim confidence factors:
- Source count — More independent sources = higher confidence
- Source quality — Publisher-stated > observed > inferred
- Freshness — Recent verification boosts confidence
- Cross-reference — Multiple sources agreeing = highest confidence
| Level | Meaning | Score Impact |
cross_ref | Confirmed by 2+ independent sources | Highest |
publisher_stated | Directly from the publisher | High |
single | One source only | Medium |
inferred | Derived from indirect evidence | Lower |
Business-stated data always wins. If you submit a correction, it supersedes web-scraped data with the highest trust level.