# noticed developer resources

noticed exposes one supported agent integration surface: a hosted Model Context Protocol server. It is intended for assistants and agents acting for an authenticated noticed user. Clients should use MCP so tool schemas, safety annotations, authorization, and resource discovery remain consistent.

## MCP endpoint

- Name: noticed
- Transport: Streamable HTTP
- [noticed MCP Streamable HTTP endpoint](https://mcp.noticed.so/api/mcp)
- Server Card: https://www.noticed.so/.well-known/mcp/server-card.json
- Synthetic sandbox MCP: https://mcp.noticed.so/api/sandbox/mcp
- Create or reset sandbox handle: https://mcp.noticed.so/api/sandbox/session
- Sandbox MCP Server Card: https://www.noticed.so/.well-known/mcp/sandbox-server-card.json
- OpenAPI 3.1 contract: https://www.noticed.so/openapi.json
- Protected-resource metadata: https://mcp.noticed.so/.well-known/oauth-protected-resource

Clients can send `initialize`, `tools/list`, `resources/list`, and reads of the server's public documentation resources without a credential. Tool calls and any access to a user's noticed data require authentication. Public listing exists only to make the interface inspectable; it never returns a user's network, notes, contact details, or account state.

## Open-source agent resources

- [noticed CLI and MCP source](https://github.com/noticedso/cli): Public source for the noticed CLI and MCP server
- [noticed relationship skills](https://github.com/noticedso/skills): Public SKILL.md workflows for relationship work
- [noticed agent labs](https://github.com/noticedso/noticed-labs): Public agent-evaluation and query-optimization skills
- [noticed relationships extension](https://github.com/noticedso/relationships-extension): Public browser-extension source for private LinkedIn imports

## Authentication and least privilege

The preferred flow is OAuth 2.1 Authorization Code with PKCE S256. noticed publishes RFC 8414 metadata at https://www.noticed.so/.well-known/oauth-authorization-server and supports RFC 7591 dynamic client registration at https://www.noticed.so/api/oauth/register. The MCP origin publishes RFC 9728 protected-resource metadata and returns a `WWW-Authenticate` challenge that points clients to it.

The current delegated scope is `network:read`. It authorizes the connected noticed MCP surface for one signed-in user's tenant. Tenant isolation and tool-level safety annotations still apply, and clients should request no scope beyond the one declared by the protected resource. Personal noticed access keys are an alternative bearer credential for clients that do not support OAuth; signed-in users create and revoke them themselves at https://www.noticed.so/settings/api-keys.

## Connect an agent

1. Configure an MCP connection to https://mcp.noticed.so/api/mcp.
2. Follow the OAuth metadata and PKCE flow, or create a personal noticed access key in settings.
3. Call `account_status` to confirm the authenticated context.
4. Inspect tool annotations before acting. Read-only tools declare read-only behavior; writes remain explicit and tenant-scoped.
5. Start with `search_people`, `get_person`, or `network_summary` for retrieval. Use write tools only when the user has asked to save or change something.

## Synthetic sandbox

Create a sandbox handle by sending `POST https://mcp.noticed.so/api/sandbox/session` with no account or payment details. Use the returned Authorization header at `https://mcp.noticed.so/api/sandbox/mcp`. The handle has only the `sandbox:read` scope and expires after 30 minutes. The sandbox is implemented separately from the production capability client and contains fixed fictional relationship fixtures only. Its complete tool surface is read-only `search_people`, `get_person`, and `network_summary`. Create another handle at the same session URL to reset.

## Access

noticed is currently available through early access. Personal access keys are self-serve after sign-in.

## Support

For integration questions, email contact@noticed.so. Public product, privacy, and security references are linked from https://www.noticed.so/llms.txt and https://www.noticed.so/sitemap.xml.